
Castopod
Open-source podcast hosting platform
Deploy Castopod in 3 Steps
Connect Your VPS
Add your server credentials to Server Compass
Select Castopod
Choose from our template library
Deploy & Configure
Fill in settings and click Deploy
Set Up Castopod from Terminal
Get your hands dirty: manual Castopod deployment guide for developers.
Log into Your Server
Access your server's command line by opening a terminal and running the SSH command below.
# SSH into your server
ssh root@your-server-ip
# Using a custom SSH key
ssh -i ~/.ssh/id_rsa root@your-server-ipFirst time? Need Docker? Install it: curl -fsSL https://get.docker.com | sh
Prepare the Install Location
Set up the folder structure for your Docker deployment.
# Create and navigate to project directory
mkdir -p ~/apps/castopod
cd ~/apps/castopodCreate docker-compose.yml
Set up your Docker Compose file with this configuration:
services:
castopod:
image: castopod/castopod:latest
ports:
- "8080:8000"
environment:
- CP_BASEURL=<your-base-url>
- CP_ANALYTICS_SALT=<your-analytics-salt>
- CP_DATABASE_HOSTNAME=db
- CP_DATABASE_NAME=castopod
- CP_DATABASE_USERNAME=castopod
- CP_DATABASE_PASSWORD=<your-db-password>
- CP_CACHE_HANDLER=redis
- CP_REDIS_HOST=redis
volumes:
- castopod_media:/var/www/castopod/public/media
restart: unless-stopped
depends_on:
db:
condition: service_healthy
redis:
condition: service_started
db:
image: mariadb:11
environment:
- MARIADB_ROOT_PASSWORD=<your-db-root-password>
- MARIADB_DATABASE=castopod
- MARIADB_USER=castopod
- MARIADB_PASSWORD=<your-db-password>
volumes:
- mariadb_data:/var/lib/mysql
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "healthcheck.sh --connect --innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
redis:
image: redis:7-alpine
restart: unless-stopped
volumes:
castopod_media:
mariadb_data:
PORTHost port(default: 8080)BASE_URLBase URLANALYTICS_SALTAnalytics saltDB_PASSWORDDB passwordDB_ROOT_PASSWORDRoot passwordRun the Deployment
Start all services defined in your compose file.
# Start the containers in detached mode
docker compose up -d
# Check if containers are running
docker compose ps
# View logs
docker compose logs -fConfigure Network Access
Open the port so you can access the application externally.
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8080Want one-click deploys? Try Server Compass.
Why type commands when you can click? Deploy Castopod the easy way with Server Compass.
- Visual configuration UI
- One-click deployment
- Automatic SSL setup
- Zero-downtime updates
- Built-in monitoring
- One-click rollbacks
After Deployment
After deploying Castopod with Server Compass, complete these steps to finish setup
Complete installation wizard
Create podcast
Upload episodes
Need help? Check out our documentation for detailed guides.
Castopod FAQ
Common questions about self-hosting Castopod
How do I deploy Castopod with Server Compass?
Simply download Server Compass, connect to your VPS, and select Castopod from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Castopod?
Castopod requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Castopod data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Castopod backup and restore procedures.
How do I update Castopod to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Castopod image will be pulled and deployed with zero downtime.
Is Castopod free to self-host?
Castopod is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host Castopod?
Download Server Compass and deploy Castopod to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass


