How To Install OctoberCMS on Ubuntu


March 18th, 2017


October is one of the leaders in Laravel CMS’s. It was originally released in 2012 and is popular with developers tired of WordPress. The attractions are that it’s easy to customize and features a clean UI so can be used for building client sites while giving them a nice backend to play with.

Installing October can be done via two methods, wizard and command line. Wizard is certainly the easiest but means that the install files have to be downloaded on your machine and then uploaded to the server. The alternative and subject of this guide is installation directly through the command line.

These steps can be carried out on your local machine or on a production server.

Create Database

Firstly we need to create the database for the project so open your db client and create it.

In SequelPro this is Choose Database > Add Database

Install the repository

SSH onto your VPS and cd to the directory where you want to install October:

1cd export/www/octobersite

Once inside run:

1curl -s | php

If it was successful you will see the message above.

Now run:

1php artisan october:install

This will generate the following message.

You will then be asked a series of questions to configure the settings for your app. Fill these out as below. You can just accept the default by pressing enter for MySql Host, MySql Port

Database Type: 0
MySQL Host: Enter (
MySQL Port: Enter
Database Name: octobersite
MySql Login: Your database username
MySql Password: Your database password
First Name: Your First Name
Second Name: Your Second Name
Email Address: Your email address
Admin Login: username to login to backend with
Admin Password: password to log into backend with

Is this information correct: Y
Application URL:

Once complete you will get the install success message!

Hit the front end in a browser and you will see the October demo theme:


Our job is not done and we must set the correct permissions on a few directories. In the site root run:

1sudo chmod -R 775 storage/
2sudo chmod -R 775 themes
3sudo chmod -R 775 storage/app/uploads

Tidy Up

It’s a good idea to move all of the configs out into a separate .env file:

1php artisan october:env

This means that configs are not hard-coded and you can control them centrally from the .env.

Make sure it is not committed to your repo!


This trial showed you how to install October CMS via the command line to get you up and running with October quickly. For more expert tutorials on October CMS and Laravel visit the Leader Internet Blog.

Filed in:

Paddy Sherry

PHP Dev | Laravel and October CMS enthusiast | Director of Software Company Leader Internet