Repository navigation
ShokoBridge v4.3.1: Docker Support & Project Cleanup
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:latestto get started. - A
docker-compose.ymlfile is now included in the repository, making setup as simple as editing a few paths and runningdocker-compose run. - This is now the recommended way to run ShokoBridge, eliminating the need for manual Python environment setup.
- ShokoBridge is now available as an official image on Docker Hub! You can pull
-
🗃️ Refactored Data Directory
- All persistent data files (
shokobridge_state.db,shokobridge_tmdb_cache.json, logs, and reports) are now stored in a singledata/directory. - This simplifies the project structure and makes mounting volumes in Docker much cleaner.
- All persistent data files (
-
📝 Documentation Overhaul
- The
README.mdhas 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.
- The
How to Upgrade or Install using Docker
-
Create a project directory on your host machine (e.g.,
/opt/shokobridge). -
Inside that directory, create your
config.jsonfile. -
Create a
docker-compose.ymlfile 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
-
Run the script from your project directory:
docker-compose run --rm shokobridge