Manual Installation Guide

Manual installation is recommended for more advanced users that would like to set up Antares on their own, specific server environment. It is also recommended to follow it when the automatic installer failed. It provides more flexibility of configuration of the server packages such as apache document root location, pre-installed apache extensions, PHP extensions and server tools.

Before the installation, it is worth to make sure that all environment’s components have been installed in versions compatible with the expected ones. You will find the instructions Automatic Installation Guide.

Please note: Manual installation is the hardest and longest way to install Antares, but gives full server customization as opposed to the auto installation. In case that you are having problems or simply you’re not experienced enough to set up your webserver on a Linux environment, please follow Automatic Installation Guide.

The following manual is dedicated for Ubuntu 14.04/16.06.

Server preconfiguration

Before you proceed with the Antares installation, you need to start with libraries which are a part of the system environment.

Just in case, run apt-get update to get the newest versions of packages and their dependencies:

apt-get update
Apache Installation

Install Apache 2.4.x or higher:

apt-get -y install apache2

Install the required Apache modules:

a2enmod headers rewrite filter deflate alias mime env

After the modules are installed, it is necessary to restart Apache:

service apache2 restart

Optionally, there might be a need for an update apache configuration file to read .htaccess file which is used by application. Edit apache2.conf file by command:

nano /etc/apache2/apache2.conf

find following lines:

<Directory /var/www/>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted

and change AllowOverride to All :

AllowOverride All
PHP 7 Installation

Install PHP 7.1.* or higher:

apt-get install software-properties-common
add-apt-repository ppa:ondrej/php
apt-get update
apt-get -y install php7.1 libapache2-mod-php7.1

Install the required PHP extensions:

apt-get -y install php7.1-bz2 php7.1-curl php7.1-fileinfo php7.1-mcrypt php7.1-gd php7.1-bcmath php7.1-xml php7.1-zip php7.1-pdo php7.1-dom php7.1-tokenizer php7.1-sqlite php7.1-gettext php7.1-mbstring php7.1-mysql

Restart Apache after the installation:

service apache2 restart
Mysql Installation

Install Mysql (MariaDB) 14.x or higher:

apt-get -y install mariadb-server mariadb-client

Run secure mySQL installation script:


You can follow these settings:

Enter current password for root (enter for none): <-- enter
Set root password? [Y/n] <-- y
New password: <-- provide a password for root user
Re-enter new password: <-- repeat password
Remove anonymous users? [Y/n] <-- y
Disallow root login remotely? [Y/n] <-- n
Remove test database and access to it? [Y/n] <-- y
Reload privilege tables now? [Y/n] <-- y
Database User Configuration

Log into MYSQL as root:

mysql -u root -p

Create a new user (Do not forget to set up the password!):

CREATE USER 'antares'@'localhost' IDENTIFIED BY 'password';

And grant him privileges to the database:

GRANT ALL PRIVILEGES ON *.* to 'antares'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Flush the privileges:

Composer Installation

Install composer 1.3.x or higher

curl -sS | php 
mv composer.phar /usr/local/bin/composer
Git Installation

Install Git 1.9.x or higher:

apt-get install git

Antares Installation

Git Clone

Firstly, go to directory:

cd /var/www

remove html directory if exists rm -rf /var/www/html. Warning! This command will remove everything you have in the html directory - make sure that there’s nothing there!

and clone GIT repository using create-project command:

composer create-project antaresproject/project /var/www/html dev-master --keep-vcs

The above command will install the application in dev-master version from git repository in your /var/www/html directory. In this case, please remember about pointing the apache at the public project directory:

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

and add following lines within VirtualHost section:

<Directory /var/www/html>
    Require all granted
    AllowOverride All

An example of valid virtualhost section should looks like:

<VirtualHost *:80>
        ServerAdmin [email protected]
        DocumentRoot /var/www/html
        # ...
        <Directory /var/www/html>
                Require all granted
                AllowOverride All
        # ...
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

Optionally you can configure permission settings for specified IPs:

<Directory /var/www/html>
   Require all granted
   AllowOverride All
   Allow from
   Allow from ::1

Once you apply the above settings, restart apache service:

service apache2 restart

More information about vhosts configuration you can find here.

Database Configuration

Create new database instance using following command:

mysql -u root -p 
create database foo CHARACTER SET=utf8 COLLATE=utf8_general_ci;

Please note: Database name “foo” is just an example, it is recommended to use your own database name.

Type exit to leave the MySQL command line.

Once created, you need to set the database connection in the file /var/www/html/.env:

nano /var/www/html/.env

Change following lines:

DB_USERNAME=<enter mysql username here>
DB_PASSWORD=<enter mysql password here>
Web-based Installer

Go to the http://<server_IP>/install in order to start migration import to the database. In the first installation step, there is an environment verification - if everything is correct please continue. If the application states that something has not been set properly, you will have to configure it before being able to proceed.


In the next step, set up the application name, username and password of the main administrator.


Please note: Do not forget to remember the password, it’s the only way to log in to the application.

Next step is about choosing optional modules:


The final step in the installation is to choose the modules which will be included in your application. Once the components are chosen and the ‘next’ button is pressed, the application creates migration files and starts the daemon that will be handling automation.


In the next step the application will inform you about the end of the installation.

Congratulations!!! The Antares application is ready to work.