General requirements

  • Have a LAMP server up and running with PHP 5.3+.
    sudo apt-get install apache2 php5 mysql-server libapache2-mod-php5 php5-mysql
  • Apache mod_rewrite is enabled.
    sudo a2enmod rewrite
These commands are given as an example if you install Novius OS on your local machine or a server for which you have admin rights.
They are Ubuntu commands, adapt them to your distribution if necessary.


In theory Novius OS can be installed on other servers than Apache.

Quick installation


  • Have a command line access to the server and being granted sudo admin rights.
  • Git is installed.


Open a terminal and enter:

cd /var/www
sudo wget && sh

Once the installation completes:


  • For a local installation, the URL is probably http://localhost/novius-os/ .
  • If your server’s DOCUMENT_ROOT isn’t /var/www/, change the first command accordingly.

Installation via Zip file

We recommend you follow this procedure when installing Novius OS on shared hosting:

Advanced installation

Configure a Virtual Host

The following commands are provided as example when installing Novius OS on Ubuntu, you should adapt depending on your distribution.

sudo nano /etc/apache2/sites-available/novius-os
Replace nano with any text editor.
Replace novius-os with the name you want for your Virtual Host.
Copy the following configuration in the file you just opened and save.
Change the line ServerName with your domain name when installing on a live server.
Likewise, change /var/www/novius-os with the folder you installed Novius OS into.
<VirtualHost *:80>
        DocumentRoot /var/www/novius-os/public
        ServerName   novius-os
        <Directory /var/www/novius-os/public>
                AllowOverride All
                Options FollowSymLinks

The default configuration has a public folder. This is where the DoumentRoot should point.

Enable the new VirtualHost:

sudo a2ensite novius-os

Then, reload Apache to apply the new configuration.

sudo service apache2 reload

Configure the hosts file, when installing on your computer

If you install Novius OS on your local computer, you must add a line in the /etc/hosts file, containing the value you entered for ServerName (novius-os in the above example).

sudo nano /etc/hosts

Add the following line:   novius-os

Advance installation with Git

You should clone the repository available on GitHub:

git clone --recursive git://

This command downloads the main repository, and its submodules :

  • novius-os : Novius OS core, which contains submodules itself (like fuel-core or fuel-orm).
  • Several submodules in local/applications: blog, news, comments, form, slideshow and other applications.
The repository default branch is latest stable version of Novius OS.
New versions will be made available in new branches.
For now, every dependent repository of novius-os/novius-os share the exact same version number. It means that any application available on our Github exists in the same versions as the core. So if you’re using the chiba version of novius-os/core, then you should also use ``novius-os/app in the same chiba version number.
After the initial clone, if you want to change the Novius OS version you’re using, don’t forget to update the submodules!
Here’s how to use the latest nightly (it’s in the dev branch):
cd /var/www/novius-os/
git checkout dev
git submodule update --recursive
Read the Docs v: chiba.1
On Read the Docs
Project Home

Free document hosting provided by Read the Docs.