This guide will explain how to install and run the app with docker on windows. most steps should be the same for every OS.

Step 1: Ensure Docker Desktop is Running

1. If you don't have Docker installed yet, download Docker Desktop for Windows from docker.com.
2. Complete the setup (ensure WSL 2 is enabled if asked).
3. Reboot your system
4. Open Docker Desktop from your Start menu.
5. Wait until the icon in the bottom-left corner turns green and shows Engine running.

---

Step 2: Create an App Folder on Your PC

You just need an empty folder where your downloaded songs and account settings will be stored:

1. Open Windows File Explorer.
2. Create a new folder named onthespot
3. Inside the onthespot folder, create another empty folder:
   • otsdata (where your logins and settings are safely stored)

---

Step 3: Create the docker-compose.yml File

A Compose file is a single text file that tells Docker which image to download and which folders on your PC to link:

1. Inside onthespot, create a new text file named docker-compose.yml. (Make sure to remove the .txt extension. If Windows hides file extensions, enable them by going to View at the top of File Explorer and checking File name extensions).

2. Right-click docker-compose.yml and open it with a text editor, like notepad.

3. Paste the following configuration:

services:
  onthespot:
    container_name: onthespot
    image: moddroid94/ots-dl:latest
    user: "1000:1000"
    # One FastAPI process serves both the API and compiled React application.
    ports:
      - "6767:6767"
    volumes:
      - "./otsdata:/root"
    restart: unless-stopped
    stop_grace_period: 20s
    networks:
      - ots-network
  
  bgutil-ytdlp-pot-provider:
    container_name: bgutil-provider
    init: true
    image: brainicism/bgutil-ytdlp-pot-provider
    networks:
      - ots-network

networks:
  ots-network:
    driver: bridge

6. Press Ctrl + S to save and close Notepad.

---

Step 4: Start the Container

1. Look at the address bar at the top of File Explorer (where it says C:\onthespot).
2. Click the empty space in the address bar, type powershell, and press Enter. 2a. you can also shift+right-click on an empty space in the folder and click "Open powershell here" or similar.
   • A terminal opens up pointed right at your folder.
3. Type (or paste) the following command and press Enter:

   docker compose up -d
   

4. What happens: Docker will download ("pull") the pre-built image layers from the registry and start the container in the background.
5. Once it prints Started onthespot-app, you can close the PowerShell window.

---

Step 5: Open and Configure the Web UI

1. Open your web browser (Chrome, Edge, Firefox, Brave, etc.).
2. In the address bar, go to:

   http://localhost:6767
   

3. The modern OnTheSpot Web interface will load!

Daily Usage (How to Stop and Restart)

You never need to touch the terminal again:

• To Stop: Open Docker Desktop, go to the Containers tab, find onthespot-app, and click the Stop (square) button.
• To Start: In Docker Desktop, click the Start (play) button next to onthespot-app, then open http://localhost:5000 in your browser.
• To Update: Whenever you want the latest version, open PowerShell in C:\onthespot and run:

  docker compose pull && docker compose up -d
  

  Docker will check for new image updates and replace the container while preserving all your saved music and settings.