Server System Requirements

  • Operating System

    Ubuntu 12.04 / 14.04 / 16.04 Server LTS (32 / 64bit) with terminal access and root permissions (sudo).

  • Hardware

    2,5GB RAM Intel/AMD x86/64 CPU with at least 2vCPUs and
    2GB free disk space.

  • Internet access

    In order to install additional software and libraries, about 200MB will be downloaded from official Canonical sources.

  • Local Network

    Server and Client need to be in the same LAN. The new webui ( will make that obsolete.

Server Installation

1. Download the latest metasfresh server installation package to your Ubuntu Server
2. Update your Ubuntu Server source list
user@host:~/$ sudo apt-get update
3. Please ensure you can resolve the hostname of your server from the command line of the server itself as well as from every client workstation.
4. Exctract the metasfresh server installation package, flag the installation file as executable and run the file “” with root permissions:
user@host:~/$ tar xvzf ./metasfresh_4_X_X.tar.gz
user@host:~/$ cd metasfresh_install
user@host:~/metasfresh_install/$ chmod a+x ./
user@host:~/metasfresh-install/$ sudo ./

After successful installation the application service will be started automatically. You’re able to start/stop/restart or check the status of the application service either as user “metasfresh” or using “sudo”:

metasfresh@host:~/$ service metasfresh_server status/stop/start/restart

The application server uses port “8080/TCP”, “61616/TCP” and for the database access port “5432/TCP”.
Please ensure your firewall is set up to allow access on these ports from all clients connecting to the application server.

Frequently Asked Questions (FAQ)

Which software will be installed?

Along with the server application, the installer will download and setup PostgreSQL-Server 9.1/9.3/9.5 and OpenJDK-8 JDK. After a successful installation, you will be able to find the binaries and config files in the folder “/opt/metasfresh” on your server.

Where am I able to find the source code?

The compressed source files will be located in the folder “/opt/metasfresh/src/” after a successful installation.
You’re able to extract the compressed archive using:
“metasfresh@host:/opt/metasfresh/src$ tar xvzf ./sources.tar.gz”
After extraction, the extracted source files will be located in a subdirectory: “./sources”

You’re also able to find the most recent source code on our website: Source Code

Which ports are used?

Port 8080/TCP:
Using this port, the client application can be downloaded from the server with an internet browser.

Port 5432/TCP:
The client application uses this port to connect to the database which will be installed on your server.

Port 61616/TCP:
This port is used for the client to communicate with the server-application.

The server update aborts and complains about missing Java 8.
What are the next steps?

Since version 4.25.24 (2016-07-08) metasfresh requires OpenJDK-8 instead of the previously installed OpenJDK-7.
You need to remove OpenJDK-7 and install OpenJDK-8 before you’re going to retry installing the update.
Here’s how you can achieve this: Update to OpenJDK-8

Do I require an active internet connection during installation?

Yes! Although the application and binary files are included in the installation package, metasfresh-server requires additional software and libraries which will automatically be downloaded and set up during the installation process.

When trying to connect to the server I get an error about a non-working “DB Connection”. Why does this error appear?

As described in step 3 of the server installation manual, the hostname of the Ubuntu server needs to be resolved by the server as well as the client workstations.
Please note: the hostname resolved in your network needs to be identical to the one set on the server itself.
If for example the hostname of your Ubuntu server is set to “erpserver”, the name needs to be pingable using “ping erpserver” in the command line interface of the server and all client workstations.
If the ping command quits with an error because it could not resolve the hostname, please add the hostname and the corresponding IP address to your DNS server, router or “hosts” files.

The installation process aborts with an error about wrong hash sums. What do I need to do?

The most common cause for this error is an issue with the locally installed official Canonical Ubuntu source lists.
To solve this issue remove your currently installed source lists and reinstall them using following commands:
user@host:~/$ sudo rm -r /var/lib/apt/lists/*
user@host:~/$ sudo apt-get update