Skip to content
Klutch.sh Docs

Deploying Yamtrack

Introduction

Yamtrack is a self-hosted media tracking application that helps you keep track of movies, TV shows, books, games, and other media you want to consume. It provides a centralized place to maintain your watchlist, reading list, and backlog while fetching metadata from various sources.

Key highlights of Yamtrack:

  • Multi-Media Support: Track movies, TV shows, books, games, and more
  • Automatic Metadata: Fetches information from TMDB, IGDB, and other sources
  • Progress Tracking: Mark items as watching, completed, or dropped
  • Rating System: Rate and review your media
  • Lists: Create custom lists for different purposes
  • Statistics: View your consumption statistics and trends
  • Modern Interface: Clean, responsive design
  • Self-Hosted: Your tracking data stays private

This guide walks through deploying Yamtrack on Klutch.sh using Docker.

Why Deploy Yamtrack on Klutch.sh

Deploying Yamtrack on Klutch.sh provides several advantages:

Privacy: Your media habits and preferences remain private.

Always Accessible: Check and update your lists from anywhere.

HTTPS by Default: Secure access with automatic SSL certificates.

Persistent Storage: Your tracking data persists with Klutch.sh volumes.

Prerequisites

Before deploying Yamtrack on Klutch.sh, ensure you have:

Deploying Yamtrack on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile:

    FROM ghcr.io/bonukai/yamtrack:latest
    

    ENV DATABASE_URL=sqlite:///data/yamtrack.db
    

    VOLUME ["/data"]
    

    EXPOSE 3000
    

    CMD ["npm", "start"]

    Push to GitHub

    Push your Dockerfile to your GitHub repository.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    Set the traffic type to HTTP with port 3000.

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    DATABASE_URLsqlite:///data/yamtrack.db
    TMDB_API_KEYYour TMDB API key (optional)

    Attach Persistent Volume

    Add a persistent volume mounted at /data for your database and configuration.

    Deploy Your Application

    Click Deploy to build and launch Yamtrack.

    Create Your Account

    Access your Yamtrack instance and create an account to start tracking your media.

Additional Resources

Conclusion

Yamtrack on Klutch.sh provides a private media tracking solution that keeps your entertainment backlog organized. Track what you want to watch, read, and play without sharing your preferences with third-party services.