Installation with Docker
Run ISPICIO_E as a Docker container, either together with a PostgreSQL database from a Compose file or connected to a separate database.
On this page
There are two ways to run ISPICIO_E with Docker:
- Option A: Docker including the database. A Compose file starts ISPICIO_E and a PostgreSQL database together.
- Option B: Docker with a separate database (recommended). The container connects to a PostgreSQL database that you have set up yourself.
Requirements
- Docker is installed and running.
- The SAP system is prepared, see Preparations in SAP.
Option A: Docker including the database
-
Create a folder, for example
ISPICIO_E. -
Open a terminal and change to this folder.
-
In this folder, create a file named
docker-compose.ymlwith the following content. Alternatively, download the example file docker-compose.yml.services: database: image: postgres container_name: ispicio_e_database ports: - '5432:5432' restart: always environment: - POSTGRES_DB=ispicio_e - POSTGRES_USER=postgres - POSTGRES_PASSWORD=NinjaPassword_123 e2022: image: ispiciogmbh/e2022 container_name: ispicio_e2022 ports: - '8080:8080' # tomcat will listen on port 8080 restart: always environment: - ISPE_DB_HOST=database - ISPE_DB_PORT=5432 - ISPE_DB_NAME=ispicio_e - ISPE_DB_USER=postgres - ISPE_DB_PASSWORD=NinjaPassword_123 links: - 'database:ispicio_e_database'The file defines two containers:
ispicio_e_databasewith the PostgreSQL databaseispicio_e, andispicio_e2022with ISPICIO_E on port 8080. -
Replace the example password
NinjaPassword_123with a password of your own.POSTGRES_PASSWORDandISPE_DB_PASSWORDmust have the same value. -
Start the containers:
docker-compose up -dDocker creates and starts the database and ISPICIO_E. ISPICIO_E creates the database schema when it starts.
-
Check that the containers are running:
docker ps -aThe command lists all containers, including stopped ones. The containers
ispicio_e_databaseandispicio_e2022must be listed with the statusUp. If a container is missing or has stopped, view its log withdocker logs <YOUR-CONTAINER-ID>.
Option B: Docker with a separate database
-
Open a terminal on the server.
-
Run the following command. Replace the placeholders in
<...>with the values of your database.docker run -d \ -e ISPE_DB_HOST='<DB-HOST>' \ -e ISPE_DB_NAME='<DB-NAME>' \ -e ISPE_DB_USER='<DB-USER>' \ -e ISPE_DB_PASSWORD='<DB-PASSWORD>' \ -p 8080:8080 \ --name ispicio_e \ ispiciogmbh/e2022If your database does not use port 5432, add the option
-e ISPE_DB_PORT='<DB-PORT>'. -
Check that the container is running:
docker ps -aThe command lists all containers, including stopped ones. The container
ispicio_emust be listed with the statusUp. If it is missing or has stopped, view its log withdocker logs <YOUR-CONTAINER-ID>.
Next step
Open ISPICIO_E in the browser at localhost:8080/e2022. The first login and the setup are described in Admin.