3 Setup via Docker Compose
Steffo edited this page 2025-11-13 02:50:12 +01:00

Threadkiller is distributed as a Docker image via Forgejo Packages.

Therefore, it can be run as a Compose project!

Assuming you have both Docker Engine and Docker Compose installed, you can install Threadkiller as follows:

  1. Create a new directory somewhere on your system, and enter it:

    # mkdir threadkiller
    # cd threadkiller
    
  2. Create a compose.yml file inside it with the following contents:

    # edit compose.yml
    
    secrets:
      tg_bot_token:
        file: "./secrets/tg_bot_token.txt"
    
    services:
      bot:
        image: "forge.steffo.eu/steffo/threadkiller"
        restart: unless-stopped
    
        environment:
          TG_BOT_TOKEN_FILE: "/run/secrets/tg_bot_token"
    
        secrets:
          - tg_bot_token
    
  3. Create a secrets subdirectory with a threadkiller.env configuration file:

    # mkdir secrets
    # edit secrets/tg_bot_token.txt
    
    123456:ABCDEF
    
  4. Start Threadkiller with the "up" command:

    # docker compose up -d && docker compose logs -f