Cup

Infrastructure64MB+ RAM

Tiny, fast Docker image update checker with a web UI

Download Server Compass Install Cup to VPS

infrastructuremonitoringcupopen-sourceself-hosteddocker

Deploy Cup in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Cup

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Cup on a VPS with Server Compass

Use the Cup template in Server Compass to deploy a self-hosted Docker image update dashboard on your VPS, then verify the setup screen.

About 10 minutesBrowser verified

Step 1

Open 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.

Server Compass Apps tab before creating a Cup app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for Cup

Use the template picker search to find Cup in the Server Compass template catalog.

Searching for Cup in the Server Compass template picker

Step 4

Select the Cup template

Choose the Cup template. Server Compass fills the Cup web service, read-only Docker socket mount, and public web port.

Step 5

Review the Cup settings

Confirm the app name and compose service. In this run, the app was named cup-demo and used host port 4259.

Reviewing Cup project settings and compose service

Step 6

Deploy Cup

Review the generated compose settings, confirm the Cup web port is available, and click Deploy.

Reviewing Cup web port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Cup image, starts the container, and verifies the stack.

Server Compass deploying the Cup template on the VPS

Step 8

Confirm Cup is running

After deployment finishes, return to the Apps tab and confirm the Cup app is marked Running with its application URL available.

Cup template running in the Server Compass Apps tab

Step 9

Open Cup in the browser

Open the application URL in a browser. The Cup setup or main page confirms the Docker image update dashboard is reachable.

The deployed Cup web UI loaded in a browser

After Cup Opens

Place Cup behind HTTPS before storing or sharing real files.
Change the generated admin password immediately after first login.
Put Cup behind authentication before exposing the dashboard.
Back up the Cup config volume because it stores provider settings and the database.
Treat the image inventory as sensitive operational data.
Use Cup output as advisory and redeploy updates through Server Compass.
Keep the Cup image updated for dependency and security fixes.

Verified Result

The Cup web interface loaded successfully from the deployed container.

Download Server Compass Docs

Cup deployment questions

What does the Cup template deploy?

It deploys the Cup Docker image update dashboard with read-only Docker socket access.

Which port did the tutorial use?

The tutorial used host port 4259, which maps to the Cup web UI on container port 8000.

Does Cup need setup after deployment?

Yes. Review image update status, then put the UI behind auth before sharing it.

Should this become a blog post?

No. The deployment guide should live on the Cup template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Cup with Server Compass, complete these steps to finish setup

Open http://YOUR_SERVER_IP:{{PORT}} - you should see the list of images on this host and their update status

Put the UI behind a reverse proxy with HTTPS and basic auth before exposing it to anyone outside the host

(Optional) Configure private registry credentials per the Cup docs if you use private images

(Optional) Schedule a periodic `cup check --json` and pipe it into your notification system (Slack/email) for an update digest

When Cup reports an update, redeploy the affected stack through Server Compass to actually pull and apply the new image

Need help? Check out our documentation for detailed guides.

Cup FAQ

Common questions about self-hosting Cup

How do I deploy Cup with Server Compass?

Simply download Server Compass, connect to your VPS, and select Cup 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 Cup?

Cup requires a minimum of 64MB 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 Cup data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Cup backup and restore procedures.

How do I update Cup to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Cup image will be pulled and deployed with zero downtime.

Is Cup free to self-host?

Cup 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.

Related Templates

View all Infrastructure

Mailu

Full-featured mail server with webmail

Postal

Mail delivery platform for transactional emails

Mailcow

Full-featured mail server with webmail

Grafana

Open-source analytics and monitoring platform

Ready to Self-Host Cup?

Download Server Compass and deploy Cup to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass