Pocket ID
| Description / name | Input element |
|---|---|
| Container Registry | |
| Container Configuration Root Path | |
| Timezone | |
| User ID | |
| Group ID | |
| Pocket ID Host Port | |
| Pocket ID /config Path |
Simple OpenID Connect and OAuth 2.0 provider that lets users sign in to your applications with passkeys.
| Port | 1411 |
| Registry | ghcr.io/daemonless/pocket-id |
| Daemonless | daemonless/pocket-id |
| Source | pocket-id/pocket-id |
| Website | pocket-id.org |
Version Tags
Multi-arch manifests — resolve automatically to the right image for your platform.
| Tag | Description | Best For |
|---|---|---|
latest |
Official upstream Pocket ID FreeBSD binary (tracks latest release). | Most users — recommended. |
pkg |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest |
FreeBSD Latest. Rolling package updates. | Staying current. |
| Tag | Description | Best For |
|---|---|---|
latest-amd64 |
Official upstream Pocket ID FreeBSD binary (tracks latest release). | Most users — recommended. |
pkg-amd64 |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest-amd64 |
FreeBSD Latest. Rolling package updates. | Staying current. |
| Tag | Description | Best For |
|---|---|---|
latest-aarch64 |
Official upstream Pocket ID FreeBSD binary (tracks latest release). | Most users — recommended. |
pkg-aarch64 |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest-aarch64 |
FreeBSD Latest. Rolling package updates. | Staying current. |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Deployment
Save as compose.yaml, then run podman-compose up -d.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
Save the files above, then run appjail-director up.
Experimental
Bastille's OCI support is experimental. It requires buildah and shares the host network stack (inherit). Mount volumes with --volume HOST JAIL; without it, image-declared volumes are stored under ${bastille_volumesdir}/${jail}.
Save as bastille-compose.yml, then run bastille up.
Open http://<server>:1411 from another machine (the server's own browser can't use a published port).
Interactive Configuration
Parameters
Environment Variables
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID for the application process |
PGID |
1000 |
Group ID for the application process |
TZ |
UTC |
Timezone for the container |
APP_URL |
http://localhost:1411 |
Public URL of Pocket ID as reached by the browser (passkeys bind to this origin) |
TRUST_PROXY |
false |
Trust X-Forwarded-* headers when running behind a reverse proxy |
ENCRYPTION_KEY |
<ENCRYPTION_KEY> |
Key used to encrypt stored secrets (openssl rand -base64 32); generated into /config/.env on first start if unset |
DB_CONNECTION_STRING |
`` | Database connection string (defaults to SQLite at data/pocket-id.db under /config, or postgres://user:pass@host:5432/dbname) |
MAXMIND_LICENSE_KEY |
<MAXMIND_LICENSE_KEY> |
MaxMind license key for automatic GeoLite2 City IP geolocation database downloads |
ANALYTICS_DISABLED |
`` | Disable outbound usage heartbeat to Pocket ID (defaults to true in this image) |
Volumes
| Path | Description |
|---|---|
/config |
Persistent configuration (/config/.env) and application data (/config/data) |
Ports
| Port | Protocol | Description |
|---|---|---|
1411 |
TCP | Web UI and OIDC provider |
First start and setup
Set APP_URL to the exact URL browsers use to reach Pocket ID (for example
https://auth.example.com), because WebAuthn passkeys are bound to that
domain and require HTTPS outside localhost. When running behind a reverse
proxy, set TRUST_PROXY=true.
Open <APP_URL>/setup on first boot to create the initial administrator
account and register your passkey.
Encryption key, data, and CLI recovery
If neither ENCRYPTION_KEY nor ENCRYPTION_KEY_FILE is set in the
environment or /config/.env on first start, the launcher generates a
32-byte key (openssl rand -base64 32) and stores it in /config/.env
(mode 0600). Back up /config: losing ENCRYPTION_KEY makes encrypted
fields in the database unreadable.
By default Pocket ID uses an embedded SQLite database at
/config/data/pocket-id.db and stores uploads in /config/data/uploads.
To use PostgreSQL instead, set DB_CONNECTION_STRING to a
postgres://user:password@host:5432/pocket_id URL.
Pocket ID CLI subcommands (such as account recovery when a passkey is lost)
run in /config as bsd via podman exec:
Pocket ID also binds an internal actor listener on port 1414 for
multi-node clustering; single-instance deployments do not need to publish it.
Implementation Details
- Architectures: amd64, aarch64
- User:
bsd(UID/GID set via PUID/PGID). Defaults to1000:1000. - Base: Built on
ghcr.io/daemonless/base(FreeBSD 15.1).
Need help? Join our Discord community.