Entropy Data

Installation

Self-hosted

This documentation will help you deploy Entropy Data on your infrastructure using various deployment methods.

This installation guide is only relevant if you use the self-hosted version of Entropy Data.

Overview

Entropy Data can be self-hosted on any cloud provider and has a simple architecture:

  • A container runtime engine (Docker, Kubernetes, AWS AppRunner, Google Cloud Run, Azure Container App)
  • A Postgres Database

And a minimal set of dependencies:

  • SMTP Mail server
  • AI Model (optional)
  • Observability (optional)

System Requirements

Before you begin, ensure your environment meets these minimum requirements and you have permissions to create these resources:

Compute

  • Minimum: 1 CPU, 2 GB RAM, 1 Instance
  • Recommended: 2+ CPUs, 4+ GB RAM, 3 Instances for production workloads

Database

  • PostgreSQL version 14 or later
  • Required extensions: vector, hstore, uuid-ossp

Email Service

SMTP server for transactional emails and notifications

  • Supported providers: Rapidmail, SendGrid, AWS SES, Azure Communication Services, and any other SMTP provider
  • Not recommended: Office 365/Exchange

Deployment Options

Docker Streamline Icon: https://streamlinehq.com

Docker

Quick start with Docker Compose for local development and testing environments.

Kubernetes Logo Streamline Icon: https://streamlinehq.com

Kubernetes

Production-ready deployment using Helm charts on any Kubernetes cluster.

Microsoft Azure Logo Streamline Icon: https://streamlinehq.com

Azure

One-click deployment on Microsoft Azure using automated Bicep templates.

Amazon Web Service Logo Streamline Icon: https://streamlinehq.com

AWS

Deploy on Amazon Web Services using CloudFormation templates.

Essential Configuration

Regardless of your deployment method, you'll need to configure these essential environment variables:

Database Configuration

SPRING_DATASOURCE_URL=jdbc:postgresql://YOUR_POSTGRES_HOST:5432/postgres
SPRING_DATASOURCE_USERNAME=your_username
SPRING_DATASOURCE_PASSWORD=your_password

Application Settings

APPLICATION_HOST_WEB=https://your-domain.com
APPLICATION_MAIL_FROM=Entropy Data <noreply@your-domain.com>

Email (SMTP) Configuration

SPRING_MAIL_HOST=smtp.example.com
SPRING_MAIL_PORT=587
SPRING_MAIL_USERNAME=your_smtp_username
SPRING_MAIL_PASSWORD=your_smtp_password
SPRING_MAIL_PROPERTIES_MAIL_SMTP_AUTH=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE=true

For a complete list of configuration options, see the Configuration page.

Next Steps

After installation:

  1. Configure environment variables - Set up your database, email, and application settings
  2. Set up SSO - Configure Single Sign-On for user authentication
  3. Enable SCIM - Set up SCIM for user provisioning (optional)
  4. Configure observability - Set up monitoring and logging
  5. Explore integrations - Connect to your data platforms and tools

Support

Upgrade from Community Edition to Enterprise Edition

Change the container image from

entropydata/entropy-data-ce:latest

to

entropydata/entropy-data:latest