Back to all templates
Yamtrack logo

Yamtrack

Application256MB+ RAM

Self-hosted media tracker for movies, TV shows, anime, manga, and games — sync with TMDB, MAL, and IGDB to track your watching/reading progress

applicationautomationyamtrackopen-sourceself-hosteddocker

Deploy Yamtrack in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Yamtrack

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Yamtrack on a VPS with Server Compass

Use the Yamtrack template in Server Compass to deploy a self-hosted media tracker for movies, TV shows, anime, manga, and games on your VPS, then verify the signup UI in a browser.

About 10 minutesBrowser verified
1
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 Yamtrack app
2
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
3
Step 3

Search for Yamtrack

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

Searching for Yamtrack in the Server Compass template picker
4
Step 4

Select the Yamtrack template

Choose the Yamtrack template. Server Compass fills the Yamtrack web service, SQLite data volume, Django secret, optional TMDB API field, and public web port.

Yamtrack template selected in Server Compass
5
Step 5

Review the Yamtrack settings

Confirm the app name, web UI port, generated SECRET, optional TMDB_API field, and yamtrack_data volume. In this run, the app was named yamtrack-demo and used host web port 4182.

Reviewing Yamtrack project settings and compose service
6
Step 6

Deploy Yamtrack

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

Reviewing Yamtrack web port before deployment
7
Step 7

Watch the deployment progress

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

Server Compass deploying the Yamtrack template on the VPS
8
Step 8

Confirm Yamtrack is running

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

Yamtrack template running in the Server Compass Apps tab
9
Step 9

Open Yamtrack in the browser

Open the application URL in a browser. The Yamtrack signup or login page confirms the media tracker is reachable.

The deployed Yamtrack web UI loaded in a browser

After Yamtrack Opens

  • Create the first account from the Yamtrack web UI.
  • Add TMDB, MAL, or IGDB API keys from Yamtrack settings if you want richer metadata sync.
  • Disable open registration from admin settings after your account is created.
  • Back up the yamtrack_data volume because it stores the SQLite database with tracked media and users.
  • Use HTTPS to protect login cookies and media history data.

Verified Result

The Yamtrack web interface loaded successfully from the deployed container.

Yamtrack deployment questions

What does the Yamtrack template deploy?

It deploys the Yamtrack media tracking web app as a single container with a persistent SQLite data volume.

Which port did the tutorial use?

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

Does Yamtrack need setup after deployment?

Yes. Open the web UI, create the first account, optionally add metadata API keys, and start tracking movies, TV shows, anime, manga, or games.

Should this become a blog post?

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

After Deployment

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

1

Visit the application URL

2

Sign up to create your account

3

Optionally provide TMDB / MAL / IGDB API keys from settings

4

Start adding media to your watching/reading lists

Need help? Check out our documentation for detailed guides.

Yamtrack FAQ

Common questions about self-hosting Yamtrack

How do I deploy Yamtrack with Server Compass?

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

Yamtrack 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 Yamtrack data?

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

How do I update Yamtrack to the latest version?

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

Is Yamtrack free to self-host?

Yamtrack 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 Yamtrack?

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

Download Server Compass