Self-host Dex on a VPS
OpenID Connect identity provider that fronts other identity sources. The install form carries config.yaml as an editable file, so it starts with a local database and the issuer address you choose.
levelrail-cli templates install dex --name my-dexSpecification
- Status
- Listed
- Category
- Security
- Services
- dex
- Ports
- 5556
- Volumes
- 1
- Memory
- about 128 MiB
- arm64
- unknown
- amd64
- unknown
- Settings to fill in
- none
- License
- Permissive license, Apache-2.0
- Listing
- Community template
About Dex
OpenID Connect identity provider that fronts other identity sources. The install form carries config.yaml as an editable file, so it starts with a local database and the issuer address you choose.
What it deploys
Dex runs as one service in a single Compose app, listening on port 5556, with 1 named volume mount.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| dex | ghcr.io/dexidp/dex | v2.46.1 | 5556 | data -> /var/dex |
Before you install
- CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
The catalog lists no environment variables for this template.
First run
- Open the address followed by /dex/.well-known/openid-configuration to see the discovery document, then edit the config file setting to add connectors and static clients.
Install Dex on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get dex -
Install it
This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.
levelrail-cli templates install dex --name my-dexTo put a service behind a domain at install, add
--domain SERVICE=HOST:levelrail-cli templates install dex --name my-dex --domain dex=dex.example.com
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Dex.
Docs and upstream
More in Security
- CryptgeonA self-destructing note and file sharing service inspired by PrivNote, with end-to-end encryption.
- CrowdSec Local APICollaborative security engine run here as the local API that other agents and bouncers register with. The log reading agent and the online API are switched off.
- CapA lightweight, privacy-friendly proof-of-work CAPTCHA, an alternative to reCAPTCHA or hCaptcha.
- authentikAn identity provider and SSO platform with flows, policies, and support for OIDC, SAML, LDAP, and proxy auth.
- AutheliaSingle sign-on and two-factor portal. The admin user is created at first boot from a generated password (visible in the service environment settings, never on a process command line); more users go in /data/users.yml. Sessions are scoped to this portal's own host, so widen the cookie domain in /config/configuration.yml before protecting other apps. One-time codes are written to /data/notification.txt.
- AnubisA reverse proxy that makes clients pass a small proof of work before reaching your site, which blocks most scraper bots. Sits in front of one upstream you choose. The signing key is generated for you.