ContentsInstallation and setup

Installation with Docker

Applies to ISPICIO_E 2.1.1.0 Last reviewed

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

Option A: Docker including the database

  1. Create a folder, for example ISPICIO_E.

  2. Open a terminal and change to this folder.

  3. In this folder, create a file named docker-compose.yml with 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_database with the PostgreSQL database ispicio_e, and ispicio_e2022 with ISPICIO_E on port 8080.

  4. Replace the example password NinjaPassword_123 with a password of your own. POSTGRES_PASSWORD and ISPE_DB_PASSWORD must have the same value.

  5. Start the containers:

    docker-compose up -d

    Docker creates and starts the database and ISPICIO_E. ISPICIO_E creates the database schema when it starts.

  6. Check that the containers are running:

    docker ps -a

    The command lists all containers, including stopped ones. The containers ispicio_e_database and ispicio_e2022 must be listed with the status Up. If a container is missing or has stopped, view its log with docker logs <YOUR-CONTAINER-ID>.

Option B: Docker with a separate database

  1. Open a terminal on the server.

  2. 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/e2022

    If your database does not use port 5432, add the option -e ISPE_DB_PORT='<DB-PORT>'.

  3. Check that the container is running:

    docker ps -a

    The command lists all containers, including stopped ones. The container ispicio_e must be listed with the status Up. If it is missing or has stopped, view its log with docker 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.