Web server and reverse proxy, configured in JavaScript
267
A single-binary web server and reverse proxy, configured in JavaScript: static files, proxying with load balancing and a response cache, TLS and HTTP/2, rate limits and metrics.
The image holds the same static binary as the Linux release archives, for amd64 and arm64, and little else: no shell, no package manager. It's under 3 MB, runs as uid 65532 and needs no added privileges.
docker run -d --name xenia -p 80:8080 -v "$PWD:/etc/xenia:ro" ofkindness/xenia
| Config | /etc/xenia/xenia.conf.js, the working directory; without one, a built-in route |
| Ports | 8080 (HTTP), 8443 (HTTPS, with --listen-tls) |
| Reload | docker kill -s HUP xenia, or docker exec xenia xenia ctl reload |
| Logs | JSON access lines on standard output, errors on standard error |
| Health | a HEALTHCHECK through the admin socket |
X.Y.Z for a release, X.Y for the newest of its minor version, and latest for the newest release. Pin X.Y.Z in production.
Each image is signed with Sigstore and carries an SPDX SBOM as an attestation. The Docker page of the docs gives the cosign 3 commands.
Xenia is free to use, commercially or not, under the Xenia License. Third-party licenses are under /licenses in the image.
Content type
Image
Digest
sha256:8fb2df8d8…
Size
1.4 MB
Last updated
17 days ago
docker pull ofkindness/xenia