docker.md

title: Official Docker images
sidebarDepth: 3

Official Docker images

Castopod pushes 3 Docker images to the Docker Hub during its automated build process:

• castopod/app: the app bundle with all of Castopod dependencies
• castopod/web-server: an Nginx configuration for Castopod
• castopod/video-clipper: an optional image building videoclips thanks to ffmpeg

Additionally, Castopod requires a MySQL-compatible database. A Redis database can be added as a cache handler.

Supported tags

• develop [unstable], latest development branch build
• beta [stable], latest beta version build
• 1.0.0-beta.x [stable], specific beta version build (since 1.0.0-beta.22)
• latest [stable], latest version build
• 1.x.x [stable], specific version build (since 1.0.0)

Example usage

1. Install docker and docker-compose

2. Create a docker-compose.yml file with the following:

   version: "3.7"
   
   services:
     app:
       image: castopod/app:latest
       container_name: "castopod-app"
       volumes:
         - castopod-media:/opt/castopod/public/media
       environment:
         MYSQL_DATABASE: castopod
         MYSQL_USER: castopod
         MYSQL_PASSWORD: changeme
         CP_BASEURL: "http://castopod.example.com"
         CP_ANALYTICS_SALT: changeme
         CP_CACHE_HANDLER: redis
         CP_REDIS_HOST: redis
       networks:
         - castopod-app
         - castopod-db
       restart: unless-stopped
   
     web-server:
       image: castopod/web-server:latest
       container_name: "castopod-web-server"
       volumes:
         - castopod-media:/var/www/html/media
       networks:
         - castopod-app
       ports:
         - 8080:80
       restart: unless-stopped
   
     mariadb:
       image: mariadb:10.5
       container_name: "castopod-mariadb"
       networks:
         - castopod-db
       volumes:
         - castopod-db:/var/lib/mysql
       environment:
         MYSQL_ROOT_PASSWORD: changeme
         MYSQL_DATABASE: castopod
         MYSQL_USER: castopod
         MYSQL_PASSWORD: changeme
       restart: unless-stopped
   
     redis:
       image: redis:7.0-alpine
       container_name: "castopod-redis"
       volumes:
         - castopod-cache:/data
       networks:
         - castopod-app
   
     # this container is optional
     # add this if you want to use the videoclips feature
     video-clipper:
       image: castopod/video-clipper:latest
       container_name: "castopod-video-clipper"
       volumes:
         - castopod-media:/opt/castopod/public/media
       environment:
         MYSQL_DATABASE: castopod
         MYSQL_USER: castopod
         MYSQL_PASSWORD: changeme
       networks:
         - castopod-db
       restart: unless-stopped
   
   volumes:
     castopod-media:
     castopod-db:
     castopod-cache:
   
   networks:
     castopod-app:
     castopod-db:

   You have to adapt some variables to your needs (e.g. CP_BASEURL, MYSQL_ROOT_PASSWORD, MYSQL_PASSWORD and CP_ANALYTICS_SALT).

3. Setup a reverse proxy for TLS (SSL/HTTPS)

   TLS is mandatory for ActivityPub to work. This job can easily be handled by a reverse proxy, for example with Caddy:

   #castopod
   castopod.example.com {
       reverse_proxy localhost:8080
   }

4. Run docker-compose up -d, wait for it to initialize and head on to https://castopod.example.com/cp-install to finish setting up Castopod!

5. You're all set, start podcasting! 🎙️🚀

Environment Variables