Builds & Features
Fluxheim is compiled with feature sets. Pick the smallest build that contains what your deployment needs.
Common builds
| Build | Use it for |
|---|---|
| full | General production server with web, proxy, cache, TLS, ACME, PHP-FPM, metrics, and tracing. |
| proxy | Reverse proxy without local static hosting or cache. |
| cache | Cache edge in front of another origin. |
| load-balancer | Focused upstream balancing and health checks. |
| php | Static web plus PHP-FPM applications such as WordPress. |
Profile examples
cargo build --release --no-default-features --features profile-full,acme-client,metrics,metrics-otlp,otel-tracing,otel-otlp
cargo build --release --no-default-features --features profile-cache-edge,acme-client
cargo build --release --no-default-features --features profile-proxy-edge,acme-client
cargo build --release --no-default-features --features profile-web-server,php-fpm,acme-client
cargo build --release --no-default-features --features profile-load-balancer-edge,acme-client
Feature families
| Family | What it adds |
|---|---|
web | Static file serving and local web routes. |
proxy | Reverse proxy routes and upstream handling. |
cache | Shared cache policy, memory and disk tiers, purge, and cache tooling. |
php-fpm | FastCGI bridge and optional managed PHP-FPM supervision. |
metrics | Prometheus metrics and optional OTLP metrics export. |
Things that cannot go together
- Pick exactly one TLS backend.
- Privacy builds do not include cache, metrics, tracing, or OTLP export.
- Focused edge images intentionally omit modules outside their job.
- Run the feature validator before packaging custom feature strings.