Knowledgebase

How to Install and Configure October CMS 2 on a Ubuntu 20.04 Server Print

  • 0

October CMS 2 is a simple and reliable content management system with features like Twig templating, extendable functionality via Plugins, built-in image cropping and advanced file management. This guide explains how to install October CMS on a Ubuntu 20.04 LAMP server.

Prerequisites

Before starting this guide:

1. Edit Apache Configuration

Edit the Apache default site configuration file to make changes that will allow October CMS to run smoothly on your server.

  1. Edit the file.

     $ sudo nano /etc/apache2/sites-enabled/000-default.conf 

    Find the line:

     DocumentRoot "/var/www/html"

    Edit the document root entry to include the rules below.

     <Directory /var/www/html/>
         Options Indexes FollowSymLinks MultiViews
         AllowOverride All
         Order allow,deny
         allow from all
     </Directory>
  2. Save and close the file

  3. Enable the mod_rewrite Apache module.

     $ sudo a2enmod rewrite
  4. Enable and start Apache at boot time.

     $ sudo systemctl enable apache2
     $ sudo systemctl start apache2
  5. Restart the service to reload the new changes.

     $ sudo systemctl restart apache2
  6. Verify Apache is running.

     $ sudo systemctl status apache2
  7. October CMS 2 requires PHP 7.2.9 or higher and several PHP extensions. To install PHP and all required extensions:

     $ sudo apt -y install php php-ctype php-curl php-xml php-fileinfo php-gd php-json php-mbstring php-mysql php-sqlite3 php-zip libapache2-mod-php

2. Create an October CMS Database

  1. Log in to MySQL as root and enter your password.

     $ sudo mysql -u root -p
  2. Create the October CMS database.

     > CREATE DATABASE october_db CHARACTER SET utf8 COLLATE utf8_general_ci;
  3. Create a new database user and assign it a strong password.

     > CREATE USER 'october_user'@'localhost' IDENTIFIED BY 'YOUR_STRONG_PASSSWORD';
  4. Grant the new user full rights to the October CMS database.

     > GRANT ALL PRIVILEGES ON october_db.* TO 'october_user'@'localhost';
  5. Refresh MySQL user privileges and exit.

     > FLUSH PRIVILEGES;
     > EXIT;
  6. Test that your newly created user has rights to the database.

     $ mysql -u october_user - p
  7. Enter the user password and display databases assigned to the user.

     > SHOW DATABASES;
  8. Enable MySQL server to start at boot time, and restart the service to apply changes.

     $ sudo systemctl enable mysql
     $ sudo systemctl restart mysql   

3. Install Composer

October CMS 2 uses Composer to manage its dependencies, the CMS does not have a direct installation candidate, and composer is used to download all necessary CMS files required to create projects.

  1. To install Composer, re-update your system and install the Composer PHP extensions.

     $ sudo apt update
     $ sudo apt install wget php-cli php-zip unzip curl
  2. Download Composer

     $ curl -sS https://getcomposer.org/installer | php
  3. Move the downloaded file to /usr/local/bin to make it a system wide application on your server.

     $ sudo mv composer.phar /usr/local/bin/composer
  4. Verify your installation and see the version.

     $ composer

4. Install October CMS 2

  1. Create a new October CMS project directory named myexample.

     $ composer create-project october/october myexample
  2. Move the new project to Apache's web root.

     $ sudo mv -R myexample/ /var/www/html/
  3. Grant Apache permissions to October CMS.

     $ sudo chown -R www-data:www-data  /var/www/html/myexample/
  4. Change the Apache 2 configuration to point to your October CMS Installation directory.

     $ sudo nano /etc/apache2/sites-enabled/000-default.conf 

    Find this line:

     DocumentRoot "/var/www/html/”

    Change it to:

     DocumentRoot "/var/www/html/myexample"
  5. Save and exit the file.

  6. Restart Apache.

     $ sudo systemctl restart apache2
  7. Change to the October CMS working directory.

     $ cd /var/www/html/myexample
  8. Run PHP Artisan.

     $ sudo php artisan october:install
  9. Choose your preferred October CMS language, English is the default.

  10. Enter your domain name, then choose a custom access URL.

     Application URL [http://localhost]:
         > 
  11. Select a custom backend URI for administration.

     Backend URI [/backend]:
         > 
  12. Select MySQL database server.

     Database Engine [SQLite]:
         [0] SQLite
         [1] MySQL
         [2] Postgres
         [3] SQL Server
         > 
  13. Use the default value of 127.0.0.1 for Database Host.

     Database Host [127.0.0.1]:
     > 
  14. Enter 3306 for database port.

     Database Port [3306] 
     > 
  15. Enter your database name, user, and password.

     Database Name [database]:
     > 
     Database Login [root]:
     >
     Database Password []:
     >
  16. Enter your October CMS license key.

     License Key:
         >
  17. Installation will continue.

  18. When finished, migrate the database to initialise the tables.

     $ sudo php artisan october:migrate
  19. Complete your October CMS configuration from a web browser. Connect to the backend URL with your domain name or server's IP address. For example:

     http://YOUR_SERVER_IP_ADDRESS/backend 
     http://YOUR_DOMAIN/backend

Next Steps

October CMS 2 is a simple and reliable content management system with features like Twig templating, extendable functionality via Plugins, built-in image cropping and advanced file management. This guide explains how to install October CMS on a Ubuntu 20.04 LAMP server. Prerequisites Before starting this guide: Deploy a new Rcs Ubuntu 20.04 server instance Create a non-root sudo user Create a DNS "A" record with a fully-qualified domain name pointed to your server Purchase an October CMS license key Install a LAMP stack. 1. Edit Apache Configuration Edit the Apache default site configuration file to make changes that will allow October CMS to run smoothly on your server. Edit the file. $ sudo nano /etc/apache2/sites-enabled/000-default.conf Find the line: DocumentRoot "/var/www/html" Edit the document root entry to include the rules below. Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all Save and close the file Enable the mod_rewrite Apache module. $ sudo a2enmod rewrite Enable and start Apache at boot time. $ sudo systemctl enable apache2 $ sudo systemctl start apache2 Restart the service to reload the new changes. $ sudo systemctl restart apache2 Verify Apache is running. $ sudo systemctl status apache2 October CMS 2 requires PHP 7.2.9 or higher and several PHP extensions. To install PHP and all required extensions: $ sudo apt -y install php php-ctype php-curl php-xml php-fileinfo php-gd php-json php-mbstring php-mysql php-sqlite3 php-zip libapache2-mod-php 2. Create an October CMS Database Log in to MySQL as root and enter your password. $ sudo mysql -u root -p Create the October CMS database. > CREATE DATABASE october_db CHARACTER SET utf8 COLLATE utf8_general_ci; Create a new database user and assign it a strong password. > CREATE USER 'october_user'@'localhost' IDENTIFIED BY 'YOUR_STRONG_PASSSWORD'; Grant the new user full rights to the October CMS database. > GRANT ALL PRIVILEGES ON october_db.* TO 'october_user'@'localhost'; Refresh MySQL user privileges and exit. > FLUSH PRIVILEGES; > EXIT; Test that your newly created user has rights to the database. $ mysql -u october_user - p Enter the user password and display databases assigned to the user. > SHOW DATABASES; Enable MySQL server to start at boot time, and restart the service to apply changes. $ sudo systemctl enable mysql $ sudo systemctl restart mysql 3. Install Composer October CMS 2 uses Composer to manage its dependencies, the CMS does not have a direct installation candidate, and composer is used to download all necessary CMS files required to create projects. To install Composer, re-update your system and install the Composer PHP extensions. $ sudo apt update $ sudo apt install wget php-cli php-zip unzip curl Download Composer $ curl -sS https://getcomposer.org/installer | php Move the downloaded file to /usr/local/bin to make it a system wide application on your server. $ sudo mv composer.phar /usr/local/bin/composer Verify your installation and see the version. $ composer 4. Install October CMS 2 Create a new October CMS project directory named myexample. $ composer create-project october/october myexample Move the new project to Apache's web root. $ sudo mv -R myexample/ /var/www/html/ Grant Apache permissions to October CMS. $ sudo chown -R www-data:www-data /var/www/html/myexample/ Change the Apache 2 configuration to point to your October CMS Installation directory. $ sudo nano /etc/apache2/sites-enabled/000-default.conf Find this line: DocumentRoot "/var/www/html/” Change it to: DocumentRoot "/var/www/html/myexample" Save and exit the file. Restart Apache. $ sudo systemctl restart apache2 Change to the October CMS working directory. $ cd /var/www/html/myexample Run PHP Artisan. $ sudo php artisan october:install Choose your preferred October CMS language, English is the default. Enter your domain name, then choose a custom access URL. Application URL [http://localhost]: > Select a custom backend URI for administration. Backend URI [/backend]: >  Select MySQL database server. Database Engine [SQLite]: [0] SQLite [1] MySQL [2] Postgres [3] SQL Server >  Use the default value of 127.0.0.1 for Database Host. Database Host [127.0.0.1]: > Enter 3306 for database port. Database Port [3306] >  Enter your database name, user, and password. Database Name [database]: >  Database Login [root]: > Database Password []: > Enter your October CMS license key. License Key: > Installation will continue. When finished, migrate the database to initialise the tables. $ sudo php artisan october:migrate Complete your October CMS configuration from a web browser. Connect to the backend URL with your domain name or server's IP address. For example: http://YOUR_SERVER_IP_ADDRESS/backend http://YOUR_DOMAIN/backend Next Steps You must create a user account to access the administration area. If you receive a connection not secure prompt, install a free Let’s encrypt SSL certificate to access your October CMS Dashboard. See the October CMS documentation for more information.

Was this answer helpful?
Back

Powered by WHMCompleteSolution