Crate albatross 

albatross

A composable HTTP server for tower::Service built around pluggable connection acceptors.

albatross provides a small, focused API for flexible connection handling through pluggable acceptors. Acceptors allow you to inspect, transform, or wrap incoming connections before they reach your application, without complicating the core server interface.

This makes it easy to add functionality such as TLS termination, automatic certificate management, protocol detection, or integration with service managers, all in a modular and composable way.

albatross works with any tower Service that matches the expected signature. While it is generally intended for use with axum, it can serve any compatible tower service.

Pluggable Acceptors

An acceptor sits between the listener and your service. Acceptors can:

• Wrap connections (e.g., TLS termination)
• Inspect or modify connection metadata
• Conditionally redirect or upgrade protocols
• Integrate with external systems

Multiple acceptors can be composed together to create the exact connection behavior your server needs.

Built-in Acceptors

The library provides several ready-to-use acceptors behind feature flags:

• systemd — integrates with systemd notifications and watchdogs
• tls — terminates HTTPS connections
• acme — similar to tls but automatically obtains and renews certificates
• https-upgrade — detects plain HTTP connections and upgrades or redirects them to HTTPS

Getting Started

Add albatross to your project:

cargo add albatross --features tls,https-upgrade

Create a server by binding a socket address and serving a tower::Service. Additional connection behavior (such as TLS or redirects) can be added using acceptors.

#[tokio::main]
async fn main() {
    let router = Router::new()
      .route("/", get(|| async { "Hello, world!" }));

    albatross::server("0.0.0.0:443")
        .with_acceptor(albatross::tls().with_certificate("cert.pem"))
        .with_https_upgrade()
        .serve(router.into_make_service())
        .await
        .unwrap();

    albatross::server("0.0.0.0:443")
        .serve(router.into_make_service())
        .await
        .unwrap();
}

Re-exports

pub use crate::accept::Accept;

pub use crate::accept::IntoAccept;

pub use crate::server::Server;

pub use crate::server::Shutdown;

Modules

accept

Core connection acceptors and utilities.

server

Server builders and shutdown primitives.

Functions

acmeacme

Creates a new ACME acceptor using the specified ACME directory URL.

server

Creates a new Server bound to the given socket address.

tlstls

Creates a new TLS acceptor.