Deployment Basics

Rust compiles to native binaries with no runtime VM. That single artifact is the core deployment advantage: copy one file, set env vars, run under systemd or Kubernetes.

Recipe

# Release build (optimized, stripped optional)
cargo build --release
./target/release/my-service
 
# Verify linked libraries (glibc vs static)
ldd target/release/my-service 2>/dev/null || file target/release/my-service

# Minimal env for a 12-factor service
export RUST_LOG=info
export PORT=8080
export DATABASE_URL=postgres://...
./target/release/my-service

When to reach for this:

• Shipping APIs, workers, and CLIs to Linux servers
• Replacing interpreted services where cold start and memory matter
• Edge or container deployments needing small images

Working Example

# Project layout
# my-service/
#   Cargo.toml
#   src/main.rs
 
cargo build --release
install -m 755 target/release/my-service /usr/local/bin/my-service
 
# systemd unit excerpt
# ExecStart=/usr/local/bin/my-service
# EnvironmentFile=/etc/my-service/env

// src/main.rs - bind port from env
use std::env;
 
#[tokio::main]
async fn main() -> anyhow::Result<()> {
    tracing_subscriber::fmt::init();
    let port: u16 = env::var("PORT")?.parse()?;
    tracing::info!(%port, "starting");
    // axum::serve(...)
    Ok(())
}

What this demonstrates:

• One binary per binary crate in Cargo.toml
• Config from environment at startup
• Structured logs via tracing for production

Deep Dive

Deployment Shapes

Health Endpoints

Expose /health (process up) and /ready (DB reachable) before traffic shifts in load balancers.

Gotchas

• Debug build in prod - 10-100x slower. Fix: always --release with profile tuned in Cargo.toml.
• Missing RUST_BACKTRACE policy - noisy logs vs debuggability. Fix: off by default, enable per incident.
• Config files baked into image - environment drift. Fix: inject env or mounted secrets.
• No graceful shutdown - dropped connections on deploy. Fix: tokio::signal and drain (see Tokio graceful shutdown).
• Huge debug symbols in image - slow pulls. Fix: strip or split debug info in CI.

Y29kZWd1aWRlcy5pb3xjZ2lvMTgyfDIwMjYwNw

Alternatives

FAQs

Related

• Minimal Docker images
• CI/CD for Rust
• Configuration & secrets in prod
• Deployment Best Practices

External Related Links

• The Cargo Book - Official guide and reference for Cargo.
• rustc Book - Compiler flags, internals overview, and usage.
• rust-lang.org - Official Rust homepage with install, learn, and community links.
• Rust in Action (Manning) - Tim McNamara.
• Programming Rust, 2nd Edition (O'Reilly) - Same Programming Rust on O'Reilly.

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+.