NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1577 most downloaded on crates.io
High level server designed to be used with axum framework.
Latest stable
0.9.1
Last release 12 days ago
10 Nov 2026
Release timing varies
gaps range from 2 weeks to 11 months
Most releases are documented
notes for 25 of 30 stable releases
3 versions withdrawn
withdrawn after publishing
5 years old
33 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
This release is yanked on crates.io. The tls-rustls-acme feature and acme module were removed in 0.9.2.
This release is yanked on crates.io. The tls-rustls-acme feature and acme module were removed in 0.9.2.
ConnectionShutdown is added to the extensions of every request and closes the connection that dispatched it, either immediately or after the in-flight response.Control, an address-agnostic handle that shares shutdown and connection counting across servers listening on different address types. Build a per-listener Handle with Handle::with_control.async_sni example that implements Accept with LazyConfigAcceptor to resolve TLS certificates asynchronously from the ClientHello.tls-rustls-acme feature and acme module, which acquire and renew certificates automatically through rustls-acme (TLS-ALPN-01, for example Let's Encrypt), plus an acme example.added: Server::first_request_timeout, which closes connections that do not send a request in time. This also covers the protocol detection read that h
Server::first_request_timeout, which closes connections that do not send a request in time. This also covers the protocol detection read that hyper does before any HTTP timeout applies.Server::accept_error_handler, which reports connection accept errors instead of silently dropping them.axum_server::tls::TlsInfo (SNI, ALPN, and client certificates) to request extensions as Arc<TlsInfo> for both rustls and OpenSSL.axum_server::accept::LocalAddrAcceptor adds the local socket address of the connection to request extensions as LocalAddr.RustlsConfig::from_sni_pem_files, which selects the certificate using the server name sent by the client through SNI.tls-rustls-encrypted-keys feature and RustlsConfig::from_pem_with_password plus file and reload variants, for encrypted PKCS#8 private keys.accept::TcpConfigAcceptor, accept::TcpSocketConfig, and accept::TcpKeepaliveConfig apply TCP_NODELAY and TCP keepalive settings to accepted connections.timeouts example showing the request, header, keep-alive, and TLS handshake timeouts.reverse_proxy example that terminates TLS and forwards requests to an HTTP upstream.tls::TlsService wrapper service. Custom acceptors that wrap a TLS acceptor and assume the service type is unchanged need to be updated; examples/rustls_session.rs now uses the built-in TlsInfo.Handle::listening() now returns None after a bind failure instead of waiting forever, and no longer races with server startup.RustlsConfig::from_pem_chain_file now sets the h2 and http/1.1 ALPN protocols like the other RustlsConfig constructors.header_read_timeout and keep_alive_timeout no longer panic with "timeout set, but no timer set".from_tcp and from_unix now put the provided listener into non-blocking mode, as required by Tokio. The from_std_listener examples work without extra setup.Server::acceptor and Server::map now preserve the HTTP version selected by http1_only/http2_only.tls-rustls feature now enables TLS 1.2, restoring the behavior from before 0.7.0.fs-err is now an optional dependency and is only pulled in by the rustls features.Your coding agent can read these notes before it upgrades. Set up the MCP server →
changed: Server is now generic over connections, allowing axum-server to listen not just on TCP.
Server is now generic over connections, allowing axum-server to listen not just on TCP.rustls-pemfile was replaced with rustls-pki-types as it is now unmaintained.Server is now generic over connections, allowing axum-server to listen not just on TCP. Support for Unix sockets has been implemented and an example for Unix sockets has been provided.rustls-pemfile with rustls-pki-types as it is now unmaintained.fixed: axum-server not compiling in hyper 1.8.0.
axum-server not compiling in hyper 1.8.0.changed: Use fs-err to augment errors loading pem files.
tower from 0.4 to 0.5.added: Crate feature tls-rustls-no-provider, which enables no rustls::CryptoProvider.
tls-rustls-no-provider, which enables no rustls::crypto::CryptoProvider.hyper-util to 0.1.2.fixed: Graceful shutdown now stops accepting requests from existing connections.
rustls from 0.21 to 0.23.tokio-rustls from 0.24 to 0.26.hyper from 1.0.1 to 1.4.http from 1.0.0 to 1.1.rustls-pki-types dependency for the tls-rustls feature.rustls::Certificate and rustls::PrivateKey with rustls_pki_types::CertificateDer and rustls_pki_types::PrivateKeyDer.ServerConfig initialization to remove with_safe_defaults() call.ClientConfig initialization in tests to use dangerous() instead of with_safe_defaults().ServerCertVerifier implementation in tests to match new rustls API.rustls-pemfile, serial_test, and tower-http.added: functionalities in tls_openssl, that were added as they appeared to be only in tls_rustls:
tls_openssl, that were added as they appeared to be only in tls_rustls:
axum_server::tls_openssl::OpenSSLConfig::from_acceptoraxum_server::tls_openssl::OpenSSLConfig::from_deraxum_server::tls_openssl::OpenSSLConfig::from_pemaxum_server::tls_openssl::OpenSSLConfig::get_inneraxum_server::tls_openssl::OpenSSLConfig::reload_from_deraxum_server::tls_openssl::OpenSSLConfig::reload_from_pemaxum_server::tls_openssl::OpenSSLConfig::reload_from_pem_fileaxum_server::tls_openssl::OpenSSLConfig::reload_from_pem_chain_filefrom_pem_chain_file method for RustlsConfig.HttpConfig and AddrIncomingConfig.axum from 0.6 to 0.7.hyper to 1.0.1.added: http2_enable_connect_protocol, http2_max_header_list_size, http2_max_pending_accept_reset_streams and http2_max_send_buf_size methods to HttpCo
http2_enable_connect_protocol, http2_max_header_list_size,
http2_max_pending_accept_reset_streams and http2_max_send_buf_size
methods to HttpConfig.breaking: Updated rustls from 0.20 to 0.21 which affects ServerConfig type.
rustls from 0.20 to 0.21 which affects
ServerConfig type.tokio-rustls from 0.23 to 0.24 which affects
TlsStream type.added: Openssl is now supported.
Nothing published for this version
changed: Handle::graceful_shutdown now informs connections about the graceful shutdown.
Handle::graceful_shutdown now informs connections about the
graceful shutdown.Nothing published for this version
added: Added tcp_keepalive_interval and tcp_keepalive_retries to AddrIncomingConfig.
tcp_keepalive_interval and tcp_keepalive_retries to
AddrIncomingConfig.added: Added Server::from_tcp, axum_server::from_tcp and axum_server::from_tcp_rustls methods to create Server from std::TcpListener.
Server::from_tcp, axum_server::from_tcp and
axum_server::from_tcp_rustls methods to create Server from
std::net::TcpListener.added: Added map, get and get_mut methods to access the acceptor of Server.
map, get and get_mut methods to access the acceptor
of Server.Added TLS handshake timeout(10 seconds).
RustlsConfig: from_pem and from_pem_file methods now accept EC
keys.AddrIncomingConfig to allow configuration of
hyper::server::conn::AddrIncoming.HttpConfig::http1_header_read_timeout.Handle::listening return type to
Option<SocketAddr>. If binding fails, Option::None will be returned.Nothing published for this version
added: Added HttpConfig to allow more configuration.
HttpConfig to allow more configuration.fixed: tls-rustls feature doesn't compile if fs feature in tokio is not enabled.
tls-rustls feature doesn't compile if fs feature in tokio is not enabled.breaking: Removed bind_rustls, certificate, certificate_file, loader, new, private_key, private_key_file, serve_and_record, tls_config methods from Se
bind_rustls, certificate, certificate_file,
loader, new, private_key, private_key_file, serve_and_record,
tls_config methods from Server.tls module.record module and feature.Handle::listening_addrs method.Server::bind method doesn't take self anymore and creates
an Server.bind method now takes a SocketAddr.bind_rustls method now takes a SocketAddr and an
tls_rustls::RustlsConfig.Server::serve method now takes a MakeService.Handle::listening method now returns SocketAddr.Handle::connection_count that can be used to get alive
connection count.service module.service::MakeServiceRef and service::SendService
traits aliases for convenience.accept module.accept::Accept trait that can be implemented to modify
io stream and service.accept::DefaultAcceptor struct that implements
accept::Accept to be used as a default 'Accept' for 'Server'.Server::acceptor method that can be used to provide a
custom accept::Accept.tls_rustls module.tls_rustls::RustlsAcceptor that can be used with
Server::acceptor to make a tls Server.tls_rustls::RustlsConfig to create rustls utilities and
to provide reload functionality.tls_rustls::bind_rustls which is same as bind_rustls
function.Nothing published for this version
- Compile on rust 1.51.
1.51.Reduced futures-util features to improve compile times.
futures-util features to improve compile times.Fixed bind and bind_rustls not working on some types.
bind and bind_rustls not working on some types.Added uri Scheme in Request extensions.
Scheme in Request extensions.Fixed serve_and_record not recording independently for each connection.
serve_and_record not recording independently for each connection.Added TlsLoader to reload tls configuration.
TlsLoader to reload tls configuration.Handle to provide additional utilities for server.Fixed an import issue when using tls-rustls feature.
Fixed an import issue when using tls-rustls feature.
Nothing published for this version
[Keep a Changelog]: https://keepachangelog.com/en/1.0.0/ [Semantic Versioning]: https://semver.org/spec/v2.0.0.html
Nothing published for this version
One column per quarter.