Fluxheim/Docs/Fluxheim Docs

Fluxheim Docs

Choose what you want to run. Each guide starts with a working example, then links to the full source docs on GitHub when you need every detail.

InstallGet Fluxheim Running

Use this page when you want a local server quickly. It keeps the config small and checks it before serving traffic.

Static SitesStatic Sites

Serve HTML, CSS, images, and downloads directly from disk. This is the simplest Fluxheim mode.

Reverse ProxyReverse Proxy

Put Fluxheim in front of an application server. Fluxheim handles TLS, headers, limits, and upstream selection.

TLS & ACMETLS & ACME

Fluxheim can serve TLS with static certificates or manage ACME certificates for you.

CacheCache

Use cache when Fluxheim sits in front of an origin and repeated responses should be served faster.

Load BalancerLoad Balancer

Run several upstreams behind one public endpoint. Start simple, then add health checks and runtime controls.

PHP-FPMPHP-FPM

Use PHP-FPM for PHP apps while Fluxheim serves static assets and forwards PHP requests safely.

WordPressWordPress

A practical PHP-FPM recipe for a normal WordPress front controller.

ObservabilityObservability

Use Prometheus and OpenTelemetry to see aggregate traffic, errors, downloads, and page usage without tracking individual visitors.

Builds & FeaturesBuilds & Features

Fluxheim is compiled with feature sets. Pick the smallest build that contains what your deployment needs.

ConfigurationConfiguration Basics

Fluxheim uses TOML. Unknown fields are rejected, so spelling mistakes fail before restart.

Systemd & ContainersSystemd & Containers

Use systemd for native hosts or rootless containers for isolated deployments.

Good first path

Install Fluxheim from a release tarball or container image.
Pick one job: static site, reverse proxy, cache, load balancer, or PHP-FPM.
Validate the TOML config before you restart the service.

How to use these docs

The website docs show the stable operational shape: what each module does, which options matter first, and a small config you can adapt. The GitHub reference keeps the exhaustive field-by-field detail.

Need	Start with
Serve files or docs	Static Sites
Put Fluxheim before an app	Reverse Proxy
Reduce origin traffic	Cache
Run PHP or WordPress	PHP-FPM or WordPress
Pick a binary profile	Builds & Features