Installation (Docker Compose)

Self-hosted

This is a guide that explains how to run Entropy Data (self-hosted) on a local machine using Docker compose.

Docker Compose

Create a docker-compose.yml file with the following content:

services:
  app:
    image: entropydata/entropy-data-ce:latest # use entropydata/entropy-data:latest for the Enterprise Edition
    platform: linux/amd64
    restart: always
    environment:
      - APPLICATION_HOST_WEB=http://localhost:8081
      - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/postgres
      - SPRING_DATASOURCE_USERNAME=postgres
      - SPRING_DATASOURCE_PASSWORD=postgres
      - SPRING_MAIL_HOST=mailhog             # mailhog is a SMTP test server, replace with your SMTP host to send emails
      - SPRING_MAIL_PORT=1025
      - APPLICATION_DATACONTRACT_SPECIFICATIONS=odcs
      - APPLICATION_SUPERADMINS=             # these users can (after registration) access the /admin site
      - APPLICATION_COMPROMISEDPASSWORDCHECKER_ENABLED=true
    ports:
      - '8081:8080'
    depends_on:
      - postgres
      - mailhog
  postgres:
    image: pgvector/pgvector:pg16
    restart: always
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - postgres:/var/lib/postgresql/data
  mailhog:
    # Test SMTP server, does not actually send mails
    # View messages in the web UI http://localhost:8025
    image: mailhog/mailhog:latest
    restart: always
    ports:
      - "8025:8025"
volumes:
  postgres:
    driver: local

Find a documentation of the environment variables in the Configuration.

This Docker Compose configuration uses a dummy mail server, so no mails are actually sent. Configure your SMTP host accordingly as environment variables, and remove the mailhog service.

Start Entropy Data with Docker Compose:

docker compose up --detach

Check the logs:

docker compose logs -f

Access Entropy Data

Now you can access the Entropy Data (Enterprise Edition) at http://localhost:8081.