Skip to content

ShokoBridge v4.3.1: Docker Support & Project Cleanup

Choose a tag to compare

@r33Cy r33Cy released this 03 Jul 17:42
· 8 commits to main since this release

This is a quality-of-life and project structure update that makes ShokoBridge significantly easier to install, run, and manage, thanks to official Docker support. While there are no new media processing features, this release fundamentally improves the user experience.

🎉 What's New

  • 🐳 Official Docker Support!

    • ShokoBridge is now available as an official image on Docker Hub! You can pull r33cy/shokobridge:latest to get started.
    • A docker-compose.yml file is now included in the repository, making setup as simple as editing a few paths and running docker-compose run.
    • This is now the recommended way to run ShokoBridge, eliminating the need for manual Python environment setup.
  • 🗃️ Refactored Data Directory

    • All persistent data files (shokobridge_state.db, shokobridge_tmdb_cache.json, logs, and reports) are now stored in a single data/ directory.
    • This simplifies the project structure and makes mounting volumes in Docker much cleaner.
  • 📝 Documentation Overhaul

    • The README.md has been updated to reflect the new Docker-first setup.
    • The project's origin story has been clarified to better explain why ShokoBridge is the essential tool for modern Plex users.

How to Upgrade or Install using Docker

  1. Create a project directory on your host machine (e.g., /opt/shokobridge).

  2. Inside that directory, create your config.json file.

  3. Create a docker-compose.yml file using the template below, making sure to edit the host-side paths to match your system.

    version: '3.8'
    services:
      shokobridge:
        image: r33cy/shokobridge:latest
        container_name: shokobridge
        volumes:
          # Mount your config file
          - ./config.json:/app/config.json:ro
          # Mount your host media paths to the container paths defined in config.json
          - /path/on/host/to/anime:/anime:ro
          - /path/on/host/to/plex-shows:/plex-shows
          - /path/on/host/to/plex-movies:/plex-movies
          # Mount a single directory for all persistent data
          - ./data:/app/data
  4. Run the script from your project directory:

    docker-compose run --rm shokobridge