Installation: Debian-Based Linux

This guide shows you how to install ARDI on Debian-based variants of Linux, including our preferred variants, Ubuntu 16.04 LTS (for virtual machines and desktops) and Raspbian for Raspberry PI.

Scripted Install

Optrix offers a Debian Install Script designed to install ARDI on some of the most popular debian-based systems, such as Ubuntu and Raspbian.

The installer should run on any relatively modern version (it must support PHP 5.6 or higher), but it has been specifically tested on…

Tested Platforms
Ubuntu 16.04 LTS
Raspbian Jessie
Debian Jessie
No Longer Available For
Ubunto 14 Or Below

Known Incompatibilities

Not Working On
Ubuntu 18.04 LTS

Currently, ARDI has an issue running with PHP 7.1 or higher, while the 18.04 version of Ubuntu defaults to using 7.2. We will be offering an update shortly.

Size

A full installation of ARDI (including all of its libraries and associated services) should consume approx. 550MB on your device.

Note that this is the initial install size only - as you add assets, your ARDI database and cache will continue to grow beyond that initial amount. Addons - particular the ARDI-VE addon - can add considerably to that amount.

Install It

Follow the steps below in a terminal window ( or via SSH )…

  • Download the script
wget http://repo.optrix.com.au/installers/debian
  • Mark the script as 'executable'
chmod a+x debian
  • Execute the script
sudo debian

or

sudo debian beta

Note that if you would like to install the unstable (pre-release) version of ARDI, you can add the word 'beta' to the end of the command - for example, sudo . debian beta will launch the installation of ARDI Unstable.


In the above example, sudo was used to run the installation with elevated priviliges. Some platforms such as Debian Jessie don't include sudo by default. In this case, login as root and skip the 'sudo' part of the command.


This will perform a full unattended installation - it will update all of the packages on the system, download and install both ARDI and all of its pre-requisites. It will also include some common additional content, such as drivers and popular addons.

As part of the installation, it will set up your first ARDI database.

Note that this script is intended for a brand new, clean system. It may overwrite or alter settings if your system offers other services.

Add Additional Drivers/Addons

This installs a basic ARDI system, but it does not include any addons and only includes the most basic drivers.

Now is a good time to install any additional software and consider installing addons.

Addons are installed using the Debian package manager. For example, to install the addon to integrate with the SeedDMS document management system, you'd type…

sudo apt-get install ardi-seeddms

Or to install the ARDI MySQL driver to access databases for live or historical information, you'd use…

sudo apt-get install ardi-mysql

See the list of ARDI addons and the list of ARDI drivers for more information on what additional components are available and what their packages are called.


Once downloaded, you'll need to install your license file. If you have issues, check our ARDI Installation Troubleshooting Guide.