General requirements

Have a serevr with MySQL and PHP 5.3+.

Novius OS can run with:

  • Linux, Mac OS or Windows (from Vista)
  • Apache with mod_rewrite enabled or Nginx


We describe following the install process on a server LAMP (Linux/Apache/MySQL/PHP), Debian type, for which you have admin rights. Adapt to your configuration.

  • Install of AMP.

    sudo apt-get install apache2 php5 mysql-server libapache2-mod-php5 php5-mysql
  • Enable mod_rewrite of Apache.

    sudo a2enmod rewrite

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.conf
Replace nano with any text editor.
Replace novius-os.conf 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.conf

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 5.0.1 version of novius-os/core, then you should also use ``novius-os/app in the same 5.0.1 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

Installation on Nginx server

Sample of Nginx configuration:

server {
listen 80;
server_name localhost;

root /var/www/novius-os;
index index.php index.html;

access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log notice;

location = /favicon.ico {
log_not_found off;
access_log off;

location = /robots.txt {
allow all;
log_not_found off;
access_log off;

error_page 404 /public/htdocs/novius-os/404.php;

autoindex off;

location @rewrites {
rewrite ^/(admin(/.*)?)$ /public/htdocs/novius-os/admin.php last;
rewrite ^/.+(.html|/)$ /public/htdocs/novius-os/front.php last;
rewrite ^/([^.]*)$ /public/htdocs/novius-os/front.php last;
rewrite ^ /public/htdocs/novius-os/front.php last;

rewrite ^/(static|cache|media|data|htdocs)/(.*) /public/$1/$2 break;
rewrite ^/install.php /public/htdocs/install.php last;

try_files $uri @rewrites;

location ~ \.php$ {
 fastcgi_split_path_info ^(.+\.php)(/.+)$;
 fastcgi_pass unix:/var/run/php5-fpm.sock;
 fastcgi_index index.php;
 include fastcgi_params;
Read the Docs v: elche
On Read the Docs
Project Home

Free document hosting provided by Read the Docs.