Installing on Debian 12

This guide covers installing Euro-Office Document Server on Debian 12 (Bookworm) from a GitHub release package.

System requirements

  • Debian 12 (Bookworm) — amd64 or arm64

  • 4 GB RAM minimum

  • 10 GB disk space minimum

Step 1 — Enable the contrib component

The ttf-mscorefonts-installer package required by Euro-Office lives in Debian’s contrib component, which is not enabled by default. Edit /etc/apt/sources.list and add contrib to each line:

deb http://deb.debian.org/debian bookworm main contrib
deb http://deb.debian.org/debian bookworm-updates main contrib
deb http://deb.debian.org/debian-security/ bookworm-security main contrib

Then update the package index:

sudo apt-get update

Step 2 — Install prerequisites

All prerequisites are available in the default Debian 12 repositories — no extra package sources are required:

sudo apt-get install -y postgresql redis-server rabbitmq-server nginx supervisor

Step 3 — Create the database

The post-install script connects to PostgreSQL during installation. Create the user and database first:

sudo -u postgres psql -c "CREATE USER ds WITH PASSWORD 'ds';"
sudo -u postgres psql -c "CREATE DATABASE ds OWNER ds;"

Step 4 — Pre-seed the installer answers

echo "ds ds/db-type select postgres
ds ds/db-host string localhost
ds ds/db-port string 5432
ds ds/db-user string ds
ds ds/db-pwd password ds
ds ds/db-name string ds" | sudo debconf-set-selections

Step 5 — Download the package

Download the latest release from GitHub Releases:

# Replace <version> and <arch> with your values, e.g. 9.3.1 and amd64 or arm64
wget "https://github.com/Euro-Office/DocumentServer/releases/download/v<version>/euro-office-documentserver_<version>_<arch>.deb" \
  -O /tmp/euro-office-documentserver.deb

Step 6 — Install the package

sudo apt-get install -y /tmp/euro-office-documentserver.deb

The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two. A successful install ends with:

Congratulations, the Euro-Office DocumentServer has been installed successfully!

Step 7 — Verify

Check that all services are running:

systemctl is-active ds-docservice ds-converter ds-metrics nginx

Expected output:

active
active
active
active

Run the health check:

curl http://localhost/healthcheck

Expected output: true

Updating

Download the new release package and reinstall:

wget "https://github.com/Euro-Office/DocumentServer/releases/download/v<new-version>/euro-office-documentserver_<new-version>_<arch>.deb" \
  -O /tmp/euro-office-documentserver.deb
sudo apt-get install -y /tmp/euro-office-documentserver.deb

Uninstalling

sudo apt-get remove --purge euro-office-documentserver
sudo -u postgres psql -c "DROP DATABASE ds;"
sudo -u postgres psql -c "DROP USER ds;"