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
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).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 ComputingRestrict the permissions of
.env, which contains secrets: for examplechmod 600 .env.Start:
bashdocker compose up -d docker compose logs -f
Files and volumes
| In the container | Source | Purpose |
|---|---|---|
/app/.env | your .env file, read-only | Configuration. |
/app/license.lic | your license.lic file, read-only | License. |
/app/data | save2erp-data volume | License user register: must be kept. |
/app/logs | save2erp-logs volume | Application logs. |
/app/translations | optional, ./translations folder | Custom 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"indocker-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_FILEandTLS_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
| Action | Command |
|---|---|
| Start | docker compose up -d |
| Renew the license | replace license.lic, then docker compose restart |
| Change the configuration | edit .env, then docker compose restart |
| Update Save2ERP | change the image version in docker-compose.yml, then docker compose up -d |
| Show the logs | docker 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.