Wonach suchst Du?
What are you looking for?

How do I install metasfresh using the Installation Package?

Installation using the metasfresh Installation Package

System Requirements:

Hardware Requirements:

Purpose: This installation aims at installing metasfresh directly on a bare-metal or a virtual machine. If you want a more flexible installation, try using metasfresh-docker.


  1. Download the latest metasfresh-server installation package to your server.
  2. Update your Ubuntu server source list.
    user@host:~/$ sudo apt update
  3. Check if you can resolve the hostname of your server on the server itself as well as on every client you want to use the Java Swing Client or WebUI interface from. Should this not be the case, check your DNS server or your host files.
  4. Install the metasfresh-server package.
    user@host:~/$ tar xvzf ./metasfresh_5_X.tar.gz
    user@host:~/$ cd metasfresh_install
    user@host:~/metasfresh_install$ chmod +x ./install_metasfresh.sh
    user@host:~/metasfresh_install$ sudo ./install_metasfresh.sh


After a successful installation, the application server as well as the webapi back end start up. Wait a few minutes for the services to be completely booted up before you try accessing the service.

When the services have been initialized, you can either:


If you want to check the statuses of the metasfresh services, you can simply stop or restart them. To do so, you can use the following commands:

user@host:~/$ sudo systemctl start/stop/restart/status metasfresh_server.service
user@host:~/$ sudo /etc/init.d/metasfresh-webui-api start/stop/restart/status

The application server uses ports 8080/TCP, 61616/TCP and 5432/TCP for communication with the Java Swing Clients. Please ensure access to these ports before trying to connect with the Java Client.

The metasfresh-WebUI uses port 80/TCP by default for browser access. Make sure to allow connections in your firewall to your server if you want to use the WebUI.

Frequently Asked Questions (FAQ)

Q: Which software/services will be installed?

A: Along with the metasfresh-server, the installer will download and setup PostgreSQL-Server 9.5, Apache2, Elasticsearch and OpenJDK-8 JDK.

Q: Where can I find the binaries and config files for metasfresh?

A: The binaries as well as their config files will be located in their respective directories under the main folder /opt/.

Q: I want to check out the source code. Where am I able to find it?

A: You can find and download the source code for all of our applications on Github: https://github.com/metasfresh.

Q: Which ports are used by metasfresh?


Q: When trying to connect to the server I get an error message about a non-working "DB Connection". Why does this error appear?

A: The hostname of the Ubuntu server needs to be resolved by the server itself 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 you have any questions or problems that have not been mentioned here, feel free to ask for support in our official public forum: forum.metasfresh.org.

View source file on GitHub.com