Skip to content

Installation

Learn how to install Komandorr using your preferred method.

Docker Installation

Recommended Method

Docker is the recommended installation method for most users.

Using Docker Run

docker run -d \
  --name komandorr \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -e PLEX_URL=http://your-plex-server:32400 \
  -e PLEX_TOKEN=your-plex-token \
  cyb3rgh05t/komandorr:latest

Using Docker Compose

Create a docker-compose.yml file:

version: "3.8"

services:
  komandorr:
    image: cyb3rgh05t/komandorr:latest
    container_name: komandorr
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - PLEX_URL=http://your-plex-server:32400
      - PLEX_TOKEN=your-plex-token
      - CHECK_INTERVAL=60
    restart: unless-stopped

Start the container:

docker-compose up -d

Manual Installation

Backend Setup

  1. Clone the repository:
git clone https://github.com/cyb3rgh05t/komandorr.git
cd komandorr
  1. Install Python dependencies:
cd backend
pip install -r requirements.txt
  1. Start the backend:
python run.py

Frontend Setup

  1. Install Node.js dependencies:
cd frontend
npm install
  1. Build the frontend:
npm run build
  1. Start the development server:
npm run dev

Verification

After installation, verify Komandorr is running:

  1. Open your browser to http://localhost:3000
  2. You should see the Komandorr login screen
  3. Default credentials: admin / admin (change immediately!)

Next Steps