Skip to main content

Installation on Linux

Check supported platforms

See the list of supported operating systems for the DBmarlin server installation.


See the checklist of requirements before starting to install the DBmarlin server.

  1. DBmarlin requires netstat which is part of net-tools. If it is not installed it can be installed using yum or apt if required.

    # Check if file exists
    which netstat

    # Install if needed RHEL or Centos
    sudo yum install net-tools

    # Install if needed Ubuntu
    sudo apt-get install net-tools
  2. Check that ports 9080, 9090 and 9070 (or the ones you choose if you customised them) are not in use before starting the DBmarlin server.

    netstat -na | grep LISTEN | grep 9080
    netstat -na | grep LISTEN | grep 9090
    netstat -na | grep LISTEN | grep 9070
  3. Create a dbmarlin Linux user and dbmarlin group and switch to that user.

     useradd dbmarlin
    mkdir /opt/dbmarlin
    chown -R dbmarlin:dbmarlin /opt/dbmarlin
    su - dbmarlin

Downloading the latest version

Download the dbmarlin-Linux-x64-[VERSION].tar.gz file from

Extracting the tar.gz file

tar -xzvf dbmarlin-Linux-x64-[VERSION].tar.gz -C /opt/

Configuring the installation

After extracting the tar.gz file you will find which needs to be run first before you can start up the server. This configures ports and other settings.

cd /opt/dbmarlin
Press Enter then space bar to scroll
Do you accept the agreement Y/N ? y
Set port for Nginx (current 9090): 9090
Set port for Tomcat (current 9080): 9080
Set port for PostgreSQL (current 9070): 9070
See for Profile sizes
1) XSmall
2) Small
3) Medium
4) Large
5) Xlarge
Choose the profile [1-5]: 2
Small profile selected
Recommended RAM is 4GB. You have 4G
Continue Y/N ? y

Configuring DBmarlin now...
Changing Nginx port from 9090 to 9090
Changing Tomcat port from 9080 to 9080
Using profile Small
All done!
Use ./ to startup the DBmarlin services

Unattended configuration (Optional)

If you want to automate the running of rather than run it interactively, you can pass in command line options. This allows installations and upgrades to be automated through automation tools.

# Example:
./ -a -n9090 -t9080 -p9070 -sMedium -u

# All parameters must be specified:
-a = Accept license agreement in LICENSE.txt
-n = Nginx port number to use
-t = Tomcat port number to use
-p = PostgreSQL port number to use
-s = Size of profile to use. Valid options are: XSmall, Small, Medium, Large, XLarge
-u = Unattended mode. Script will complete without prompting for Y/N to proceed

For descriptions of profile sizes see Hardware requirements

Starting DBmarlin server processes

All server processes (nginx, tomcat, postgres) can be started with a single command.

cd /opt/dbmarlin

Checking the status of DBmarlin server processes

Check the status of the DBmarlin server processes with the command.

cd /opt/dbmarlin

nginx (Running)
tomcat (Running)
postgres (Running)

Stopping the DBmarlin server processes

All server processes (nginx, tomcat, postgres) can be stopped with a single command.

cd /opt/dbmarlin

Video Walkthough

This short video walkthough covers all the steps listed above showing how to get DBmarlin up and running on Linux.