Installation

Pre-built binaries

Download the latest release from the GitHub Releases page. Binaries are available for Linux (x86_64 and aarch64).

After downloading, make the binary executable and move it somewhere in your PATH:

chmod +x infrarust
sudo mv infrarust /usr/local/bin/

Verify the installation:

infrarust --help

Docker

Infrarust ships a minimal Docker image built from scratch with a statically linked binary. The image exposes ports 25565 (proxy) and 8080 (admin API), and expects your configuration at /app/config.

docker run -d \
  --name infrarust \
  -p 25565:25565 \
  -v ./config:/app/config \
  ghcr.io/shadowner/infrarust:latest

Create a config/ directory with your infrarust.toml, a servers/ subdirectory for server definitions, and a plugins/ subdirectory before starting the container.

Docker Compose

services:
  infrarust:
    image: ghcr.io/shadowner/infrarust:latest
    ports:
      - "25565:25565"
      - "8080:8080"
    volumes:
      - ./config:/app/config
    restart: unless-stopped

Building the image yourself

The included Dockerfile uses a multi-stage build with Alpine and produces a statically linked binary. It also builds the admin frontend with Node.js. Supported architectures are x86_64, aarch64, and armv7:

docker build -t infrarust .

Build from source

Requirements

• Rust 1.94 or later (edition 2024)
• A C compiler and linker (gcc or clang). The default build compiles libdeflate for packet compression. For a pure-Rust build with no C toolchain, see Optional features.
• OpenSSL development headers (for TLS support)

On Debian/Ubuntu:

sudo apt install build-essential pkg-config libssl-dev

On Alpine:

apk add musl-dev pkgconfig openssl-dev build-base

Compile

Clone the repository and build the infrarust crate, which produces the infrarust binary:

git clone https://github.com/Shadowner/Infrarust.git
cd Infrarust
cargo build --release -p infrarust

The binary is at target/release/infrarust.

Optional features

Enable features at compile time with --features:

Feature	Default	What it adds
libdeflater	yes	libdeflate packet compression (needs a C compiler)
default-plugins	yes	Bundles plugin-auth and plugin-server-wake
plugin-auth	via default-plugins	Built-in authentication plugin
plugin-server-wake	via default-plugins	Holds players in limbo while their target server starts up
plugin-hello	no	Example hello-world plugin
docker	no	Docker integration for managing backend containers
telemetry	no	OpenTelemetry tracing export
wasm	no	WASM plugin loader

cargo build --release -p infrarust --features telemetry,plugin-auth

To build without a C toolchain, drop the default libdeflater feature. The proxy then uses the pure-Rust flate2 backend for packet compression:

cargo build --release -p infrarust --no-default-features --features default-plugins

Static linking (musl)

For a fully static binary (no runtime dependencies), target musl. This is what the Docker image uses:

rustup target add x86_64-unknown-linux-musl
OPENSSL_STATIC=1 cargo build --release -p infrarust \
  --target x86_64-unknown-linux-musl

CLI usage

infrarust [OPTIONS]

Option	Default	Description
-c, --config <PATH>	infrarust.toml	Path to the proxy configuration file
-b, --bind <ADDR>	(from config)	Override the bind address, e.g. 0.0.0.0:25577
-l, --log-level <LEVEL>	info	Log level filter (trace, debug, info, warn, error)
--plugins-dir <PATH>	(from config)	Override the plugins directory path

The RUST_LOG environment variable takes priority over --log-level when both are set.

Next steps

Once Infrarust is installed, head to Quick Start to set up your first proxy configuration.