The Shellui admin app as a static nginx image, configured at runtime.
2.0K
Company owners and staff manage users, groups, sign-in, storage, hosting, and email in Shellui admin at /admin. The shell is the host around your application. It embeds Shellui admin and passes the session and service URLs through @shellui/sdk.
nginx in this image serves the static admin build. It stores no secrets and no service URLs.
The image includes:
nginxinc/nginx-unprivileged:1.29-alpine-slim8080/docker-entrypoint.sh, which runs /docker-entrypoint.d/40-shellui-frame-ancestors.sh before nginx101 (non-root)The publish workflow builds linux/amd64 and linux/arm64.
Set FRAME_ANCESTORS to each shell origin that may embed the app. Replace the placeholder with your origin. Separate extra origins with a space.
This command publishes port 8080 and sets one origin:
docker run -p 8080:8080 \
-e FRAME_ANCESTORS="https://your-shell-origin.example.com" \
shellui/admin:latest
This Compose file starts the same image with the same variable:
services:
admin:
image: shellui/admin:latest
ports:
- '8080:8080'
environment:
FRAME_ANCESTORS: 'https://your-shell-origin.example.com'
Opening the container URL directly shows the notice Open this app from Shellui. Set backend.adminUrl to the origin you published, keep backend.adminPathname at /admin, and open that route in the shell.
This image reads only FRAME_ANCESTORS. The shell passes backend.url, storage.url, hosting.url, and email.url when it embeds the app.
| Variable | Required | Description |
|---|---|---|
FRAME_ANCESTORS | Yes in production | Space-separated origins allowed to embed the app. Each entry is 'self' or an http(s) origin. A bare * is refused. When you omit it, the Content Security Policy allows only 'self'. |
Read the full image configuration in the Docker image section of the development notes.
The publish workflow pushes these tags:
X.Y.Z: release version, such as 0.10.0 from tag v0.10.0X.Y: major and minor, such as 0.10latest: the highest stable releasePublishing a pre-release, or a stable tag below the highest, leaves latest on the highest stable release.
The image health check runs wget against http://127.0.0.1:8080/health. It runs every 30s, with a 3s timeout, a 5s start period, and 3 retries. nginx returns 200 and the body ok.
The repository, docs site, changelog, license, and product site:
Content type
Image
Digest
sha256:bf69204d5…
Size
6.9 MB
Last updated
4 days ago
docker pull shellui/admin