Installation and Configuration of October CMS
October CMS 3 is installed via Composer. Requirements: PHP 8.1+, MySQL 5.7+/PostgreSQL 9.6+/SQLite 3, extensions: BCMath, Ctype, FileInfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML.
Installation
composer create-project october/october myproject
cd myproject
php artisan october:install
# Wizard will configure DB, create first user, choose theme
Manual .env Configuration
APP_NAME="My Site"
APP_ENV=production
APP_KEY=base64:...
APP_DEBUG=false
APP_URL=https://mysite.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=october_prod
DB_USERNAME=october
DB_PASSWORD=secret
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=secret
MAIL_ENCRYPTION=tls
[email protected]
CMS Configuration
// config/cms.php — main settings
return [
'backendUri' => '/manage', // instead of /backend
'activeTheme' => 'mytheme',
'themesPath' => '~/themes',
'pluginsPath' => '~/plugins',
'maxAssetSize' => '10', // MB
'enableTwig' => true,
'strictVariables' => false,
'enableAssetMinify' => env('APP_ENV') === 'production',
'enableAssetCache' => true,
'enableRoutesCache' => env('APP_ENV') === 'production',
'enablePageCache' => false, // configure separately via plugin
];
Plugin Installation
# Via Marketplace
php artisan plugin:install rainlab.blog
php artisan plugin:install rainlab.pages
php artisan plugin:install rainlab.translate
php artisan plugin:install rainlab.user
php artisan plugin:install rainlab.seo
# From private repository
composer require myvendor/myplugin
php artisan october:migrate
Nginx Configuration
server {
listen 80;
server_name mysite.com;
root /var/www/mysite;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
# Block access to service directories
location ~* /\.(ht|git|env) { deny all; }
location ~* ^/(config|storage|vendor)/ { deny all; }
}
Installation and basic configuration of October CMS with theme takes 4–6 hours.