1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Pocket ID
Infrastructure256MB+ RAM
Simple, passkey-first OIDC identity provider - replace Authelia/Keycloak for self-hosted SSO with a minimal footprint
infrastructurenetworkingpocketidopen-sourceself-hosteddocker
Deploy Pocket ID in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Pocket ID
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Pocket ID on a VPS with Server Compass
Use the Pocket ID template in Server Compass to deploy a self-hosted OIDC identity provider with passkey login, then verify the web UI in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Pocket ID
Use the template picker search to find Pocket ID in the Server Compass template catalog.
4
Step 4Select the Pocket ID template
Choose the Pocket ID template. Server Compass fills the web service, public app URL, trust-proxy setting, encryption key, and persistent data volume.
5
Step 5Review the Pocket ID settings
Confirm the app name and web UI port. In this run, the app was named pocket-id-demo and used host port 4090.
6
Step 6Deploy Pocket ID
Review the generated compose settings, confirm the Pocket ID web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Pocket ID image, starts the container, and verifies the stack.
8
Step 8Confirm Pocket ID is running
After deployment finishes, return to the Apps tab and confirm the Pocket ID app is marked Running with its application URL available.
9
Step 9Open Pocket ID in the browser
Open the application URL in a browser. The Pocket ID setup or login page confirms the identity provider is reachable.
After Pocket ID Opens
- Create the initial administrator account if prompted.
- Configure a real HTTPS domain before registering passkeys for production use.
- Add OIDC clients for the apps that should use Pocket ID login.
- Back up the Pocket ID data volume.
Verified Result
The Pocket ID web interface loaded successfully from the deployed container.
Pocket ID deployment questions
What does the Pocket ID template deploy?
It deploys the Pocket ID web app with persistent local data for users, OIDC clients, and passkey/OIDC configuration.
Which port did the tutorial use?
The tutorial used host port 4090, which maps to the Pocket ID web UI on container port 1411.
Does Pocket ID need setup after deployment?
Yes. Create the initial admin account, configure the public URL, and add OIDC clients before using it with other apps.
Should this become a blog post?
No. The deployment guide should live on the Pocket ID template detail page and be linked from the reusable template deployment docs page.
After Deployment
After deploying Pocket ID with Server Compass, complete these steps to finish setup
1
Open /setup and create the initial admin user (register a passkey, not a password)
2
Add OIDC clients for each app you want to protect (note the client ID/secret and redirect URI)
3
Invite additional users from the admin panel - each user registers their own passkey
4
Configure SMTP under Settings if you want password-reset or invitation emails
Need help? Check out our documentation for detailed guides.
Pocket ID FAQ
Common questions about self-hosting Pocket ID
How do I deploy Pocket ID with Server Compass?
Simply download Server Compass, connect to your VPS, and select Pocket ID from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Pocket ID?
Pocket ID requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Pocket ID data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Pocket ID backup and restore procedures.
How do I update Pocket ID to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Pocket ID image will be pulled and deployed with zero downtime.
Is Pocket ID free to self-host?
Pocket ID is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host Pocket ID?
Download Server Compass and deploy Pocket ID to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass