Skip to content

Installing with Docker ​

The Save2ERP Docker image is the same for all customers: it contains the application and its dependencies, without configuration, license or data. You provide your own files when the container starts.

Install ​

  1. Get the image, with the registry access token (docker login ghcr.io) or from the file provided by Swiss Computing (docker load -i save2erp-<version>.tar.gz).

  2. Prepare a folder on the server, for example /opt/save2erp/:

    /opt/save2erp/
    ├── docker-compose.yml   provided by Swiss Computing
    ├── .env                 your configuration (template: .env.example), with NODE_ENV=production
    └── license.lic          the license provided by Swiss Computing
  3. Restrict the permissions of .env, which contains secrets: for example chmod 600 .env.

  4. Start:

    bash
    docker compose up -d
    docker compose logs -f

Files and volumes ​

In the containerSourcePurpose
/app/.envyour .env file, read-onlyConfiguration.
/app/license.licyour license.lic file, read-onlyLicense.
/app/datasave2erp-data volumeLicense user register: must be kept.
/app/logssave2erp-logs volumeApplication logs.
/app/translationsoptional, ./translations folderCustom texts (see Customizing the panel texts).

The .env file is mounted as a file. Do not pass it with env_file or docker run --env-file: these options do not remove end-of-line comments (SERVER_PORT=5000 # … would become an invalid port).

HTTPS ​

Word requires a valid certificate. Two options:

  • Behind the company's HTTPS proxy (nginx, Traefik, IIS…), the simplest: see Behind an HTTPS proxy. If the proxy runs on the same server, publish the port locally only, with "127.0.0.1:5000:5000" in docker-compose.yml: Docker opens published ports even if the server's firewall blocks them.
  • The server handles HTTPS itself: mount the key and the certificate in the container, and set their paths in TLS_KEY_FILE and TLS_CERT_FILE.

Company certificate authority ​

If the target system uses a certificate issued by an internal authority, mount that authority's certificate (PEM format) in the container and set its path in the NODE_EXTRA_CA_CERTS variable, for example in the environment: section of docker-compose.yml.

Time zone ​

The time in the logs follows the TZ variable in docker-compose.yml (Europe/Zurich in the provided file). Without it, the time is in UTC.

Commands ​

ActionCommand
Startdocker compose up -d
Renew the licensereplace license.lic, then docker compose restart
Change the configurationedit .env, then docker compose restart
Update Save2ERPchange the image version in docker-compose.yml, then docker compose up -d
Show the logsdocker compose logs -f, or docker compose exec save2erp tail -f logs/all.log

Only one Save2ERP instance must run per customer: the user register is a local file.