HUB
Sign inSign up

ofkindness/xenia

By ofkindness

•Updated 17 days ago

Web server and reverse proxy, configured in JavaScript

Image
0

267

ofkindness/xenia repository overview

⁠Xenia

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
Ports8080 (HTTP), 8443 (HTTPS, with --listen-tls)
Reloaddocker kill -s HUP xenia, or docker exec xenia xenia ctl reload
LogsJSON access lines on standard output, errors on standard error
Healtha HEALTHCHECK through the admin socket

⁠Tags

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.

⁠Verifying

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.

Tag summary

Content type

Image

Digest

sha256:8fb2df8d8…

Size

1.4 MB

Last updated

17 days ago

docker pull ofkindness/xenia