Laravel Tutorials

How To Install OctoberCMS on Ubuntu

Published
How To Install OctoberCMS on Ubuntu image

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:

cd export/www/octobersite

Once inside run:

curl -s https://octobercms.com/api/installer | php

If it was successful you will see the message above.

Now run:

php 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 (127.0.0.1) 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: https://octobersite.com

Once complete you will get the install success message!

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

Permissions

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

sudo chmod -R 775 storage/
sudo chmod -R 775 themes
sudo 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:

php 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!

Conclusion

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.

Paddy Sherry photo

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

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article