October CMS
Modern Laravel-based CMS for developers
Deploy October CMS in 3 Steps
Connect Your VPS
Add your server credentials to Server Compass
Select October CMS
Choose from our template library
Deploy & Configure
Fill in settings and click Deploy
Deploy October CMS Yourself
Want full control? Here's how to deploy October CMS yourself using Docker Compose.
Access Your VPS Terminal
Use your terminal to securely access your server. You'll need your server's IP address.
# Connect via SSH
ssh root@your-vps-ip
# Alternative with key file
ssh -i /path/to/key root@your-vps-ipFirst time? Make sure Docker is installed on your VPS. Run: curl -fsSL https://get.docker.com | sh
Set Up the Deployment Folder
Initialize a project folder on your server.
# Create and navigate to project directory
mkdir -p ~/apps/octobercms
cd ~/apps/octobercmsSet Up the Stack Definition
Use this Docker Compose configuration for your deployment:
services:
october:
image: php:8.2-apache
ports:
- "8080:80"
environment:
- DB_CONNECTION=mysql
- DB_HOST=db
- DB_PORT=3306
- DB_DATABASE=october
- DB_USERNAME=october
- DB_PASSWORD=<your-db-password>
volumes:
- october_data:/var/www/html
restart: unless-stopped
depends_on:
db:
condition: service_healthy
command: >
bash -c "
docker-php-ext-install pdo pdo_mysql mysqli > /dev/null 2>&1;
a2enmod rewrite > /dev/null 2>&1;
if [ ! -f /var/www/html/artisan ]; then
apt-get update -qq && apt-get install -y -qq git unzip libzip-dev > /dev/null 2>&1 &&
docker-php-ext-install zip > /dev/null 2>&1 &&
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer &&
composer create-project october/october /var/www/html --no-interaction --prefer-dist &&
cd /var/www/html && php artisan october:migrate --force &&
chown -R www-data:www-data /var/www/html;
fi;
apache2-foreground
"
db:
image: mysql:8.0
environment:
- MYSQL_ROOT_PASSWORD=<your-db-root-password>
- MYSQL_DATABASE=october
- MYSQL_USER=october
- MYSQL_PASSWORD=<your-db-password>
volumes:
- db_data:/var/lib/mysql
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -p$$MYSQL_ROOT_PASSWORD || exit 1"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
volumes:
october_data:
db_data:
PORTHost port to expose(default: 8080)DB_NAMEDatabase name(default: october)DB_USERDatabase user(default: october)DB_PASSWORDDatabase passwordDB_ROOT_PASSWORDRoot passwordStart the Containers
Bring up your containers in detached mode.
# Start all services
docker compose up -d
# List running containers
docker compose ps
# Watch the logs
docker compose logs -fSet Up Firewall Rules
Allow the application port through your server's firewall.
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8080Let Server Compass do the heavy lifting.
Skip the terminal and deploy October CMS with a visual interface. Configure everything with clicks, not commands.
- Beautiful interface
- One-click deploys
- Let's Encrypt SSL
- Zero downtime
- Container monitoring
- Easy rollbacks
After Deployment
After deploying October CMS with Server Compass, complete these steps to finish setup
Complete installation wizard
Set up admin credentials
Install themes and plugins from the marketplace
Need help? Check out our documentation for detailed guides.
October CMS FAQ
Common questions about self-hosting October CMS
How do I deploy October CMS with Server Compass?
Simply download Server Compass, connect to your VPS, and select October CMS 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 October CMS?
October CMS 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 October CMS data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard October CMS backup and restore procedures.
How do I update October CMS to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest October CMS image will be pulled and deployed with zero downtime.
Is October CMS free to self-host?
October CMS 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 October CMS?
Download Server Compass and deploy October CMS to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass


