You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.

2 - Create Service

For this example, we are going to create a simple Rust project that serves a static web page.

mkdir hello-world && cd hello-world
cargo init
touch src/index.html

In index.html add:

    <title>Hello World!</title>
    <h1>Hello World!</h1>

In add:

use hyper::service::{make_service_fn, service_fn};
use hyper::{body::Bytes, Body, Request, Response, Server};
use std::convert::Infallible;
use std::net::SocketAddr;

async fn handle(_req: Request<Body>) -> Result<Response<Body>, Infallible> {

async fn main() {
    // Construct our SocketAddr to listen on...
    let addr = SocketAddr::from(([0, 0, 0, 0], 80));

    // And a MakeService to handle each connection...
    let make_service = make_service_fn(|_conn| async { Ok::<_, Infallible>(service_fn(handle)) });

    // Then bind and serve...
    let server = Server::bind(&addr).serve(make_service);

    // And run forever...
    if let Err(e) = server.await {
        eprintln!("server error: {}", e);

Finally, in our Cargo.toml, we need to add some dependencies, which will look like this:

hyper = { version = "0.14.4", features = ["server", "http1", "http2", "tcp", "stream"] }
tokio = { version = "1.4.0", features = ["full"] }

That’s it! We now have the code for our service.

Let’s build and run it!

# build the project
cargo build
# start the executable

Visit http://localhost:80 to see your running web page!