Skip to the content.

XPACS Installation Guide



First, update the system’s package list by apt update. Docker Engine is often preinstalled on Linux machines, if not then read Docker Compose can be installed by apt install docker-compose.



Create a folder and change the current directory to it. Download and unzip file by the following commands:


Sinology NAS does not include unzip so use the following command:

7z x

Open file .env and edit two settings:

Setting Description
STORAGE_FOLDER The absolute folder path where XPACS stores data
IMPORT_FOLDER The absolute folder path where one puts files to be imported by XPACS

The XPACS repositories are not public so you must be authenticated by the following command (enter user credentials that are authorized to pull these repositories):

docker login

Make the script executable and run it by the following commands (select the install option in the script):

chmod +x

After finishing the script, check that all XPACS-related containers are up and running (prefix can be xpacs, root, etc.):

Container Name Description
prefix_core_* XPACS core service
prefix_web_* XPACS web portal
prefix_api_* XPACS web API
prefix_import_* XPACS import service
prefix_db_* Microsoft SQL Server
prefix_logger_* Seq log service

Getting Updates

XPACS repositories might have updates on the Docker Hub. If so run the script (select the update option in the script) to pull and apply changes.