On-premise system requirements

This page describes what a server needs to run DataMind OS for one organization. Use it when choosing an OS, sizing hardware, planning network access, and configuring firewall rules before deployment. When the host is ready, follow Install on a fresh host.

Operating system

Linux is highly recommended and is the only platform DataMind tests and supports. Any modern, mainstream Linux distribution with a recent Docker Engine and the Docker Compose v2 plugin works. Ubuntu, Debian, and RHEL/Rocky/Alma are all fine choices.

Running on Windows or macOS (via Docker Desktop) is technically possible for a quick local test, but it is not supported for production use.

Note

If you are migrating an existing bare-metal installation rather than starting fresh, the migration tooling requires a systemd-based Linux distribution. This covers virtually every mainstream server distro (Ubuntu, Debian, RHEL and derivatives, Fedora, SUSE), but rules out non-systemd distributions like Alpine.

Hardware

TierCPURAMStorageFits
Minimum (evaluation/pilot)2 vCPU16 GB128 GB SSDSmall datasets, no heavy ETL, evaluating the platform
Recommended (production)16 vCPU64 GB512 GB SSDEveryday production: regular ETL jobs, a normal-sized data warehouse, dozens of BI users
Large-scale (heavy production)32+ vCPU128 GB+2 TB+ SSDLarge data warehouse, many concurrent BI users, parallel ETL jobs, long data/log retention

SSD storage is recommended. The platform is disk-latency sensitive, especially the data warehouse and reporting components.

There is no hard ceiling above the large-scale tier, and storage in particular is a starting point rather than a fixed number at any tier. Resource and disk needs keep growing with your data volume, user count, and workload. The platform is especially RAM-hungry as workload grows, since the data warehouse, database, and ETL engine all hold much of their working set in memory. If you load large volumes of data, keep years of history, or scale past the table above, check in with your DataMind contact for sizing guidance.

Network

The server needs outbound internet access. Inbound access is not required beyond the ports listed in the next section. Outbound access is used to reach:

DomainPurpose
unistream.azurecr.ioContainer registry. Every DataMind OS software image is pulled from here
unistream.blob.core.windows.netBlob storage. Hosts install files (for example, the Docker Compose file) and some UI assets
ai.unistream.cloudAI access platform used by the platform's AI features
docs.unistream.cloudDocumentation links shown in the app (optional)

No special bandwidth requirements. A standard internet connection is enough. If your firewall only allows specific outbound domains, allowlist these four.

Ports

PortPurpose
8000Deploy manager. Needed by whoever performs the initial installation or a migration
80HTTP (redirects to HTTPS)
443HTTPS. The platform itself: the app, dashboards, and reports

Internal ports

Everything below runs behind the scenes and can optionally be exposed to admin users.

Warning

These internal ports should not be exposed to the public internet. Expose them only to your internal network.

PortServicePurpose
8081FrontendDirect access to the web app, bypassing the main site
8082Backend APIDirect API access
7070Carte (Pentaho/Kettle)ETL tool for building and monitoring data pipelines
8001Meltano APIData connector management
7000RosettaDocument layout and table recognition service
4000MCP serverClaude AI tool integration endpoint
9090LurienQuery editor, BI-layout service, direct API access
5432PostgresMain database
8123, 9000ClickHouseData warehouse (HTTP + native)
8888ClickHouse APIJDBC data connector API
6379Redis (backend)Cache and session store
6333, 6334QdrantVector database (AI search)
4222, 8222NATSInternal messaging and monitoring
9002, 9003RustFSFile storage API and admin console
6901RedashDirect BI dashboard access, bypassing the main site
1080, 1025MaildevMail testing tool (non-production use)
8002Service metrics APIInternal monitoring
9428VictoriaLogsLog storage and viewer

Questions

If you are unsure how to size a server for your data volume or user count, reach out to your DataMind contact before provisioning. It is a quick conversation and saves a resize later.