Self-hosted setup

Self-hosted DataMaker requires access to the deployment bundle or repository and the release images. Obtain that access, the intended release version and license configuration from Automators or your administrator before starting. The application repository is not a public anonymous download.

Requirements

The supplied Compose setup targets Linux AMD64, Docker Engine 24 or later and Docker Compose 2.24 or later. Start with at least 4 vCPU, 8 GB RAM and 40 GB disk, then size storage and workers for your workload. These are starting requirements, not a capacity guarantee.

Prepare the app and API hostnames, inbound HTTPS routing, storage and outbound access to your chosen AI providers and connected systems. Private registry images require credentials with package-read access.

Configure the deployment bundle

In the supplied hosting directory:

cp .env.example .env
chmod 600 .env
cp Caddyfile.example Caddyfile

Fill in the release version, domains, datastore configuration and AI provider settings from the example file. Generate unique secrets for DATAMAKER_TOKEN_SECRET, CHAT_SECRET, CRYPT_SECRET, POSTGRES_PASSWORD and REDIS_PASSWORD when using bundled datastores. Store them securely and retain them across upgrades.

Configure AUTOMATORS_SESSION_PUBLIC_KEYS using the signing public keys supplied by your Automators Auth deployment. These are verification keys; do not place Auth's private signing key in DataMaker. See Authentication.

You do not need a key in hand to deploy. Bring the stack up and sign in, and the licensing surface - the wall, or Settings → License - offers two paths:

• Request a license. The server files a request with the issuer over outbound HTTPS, carrying your contact email, company and this deployment's public origin. Automators reviews it; the server polls for the outcome and activates the issued key itself once approved. A denial appears in the same place with the reviewer's note.
• Paste a key you were sent directly.

Set DATAMAKER_PUBLIC_URL to the real browser-facing origin before requesting: it is this deployment's identity with the issuer as well as the URL the browser uses. DATAMAKER_LICENSE_REQUIRED=1 makes a valid license mandatory, and until one is active the deployment serves only sign-in and the licensing surfaces.

A deployment cannot mint its own license. It carries the public keys it verifies against and no signing key, so a requested key is verified exactly like a pasted one. Do not remove license enforcement to work around a configuration error.

Start and verify

Point DNS at the host and confirm the TLS routing configuration, then start the bundled services:

docker compose up -d
docker compose logs -f datamaker-init
docker compose ps

Wait for schema initialization to complete successfully. Verify HTTPS, sign-in, project access, a small generation, scenario execution and a downloadable output before admitting normal traffic. Stop the log-follow command once initialization is complete.

The default bundle includes datastores. If using external Postgres or Redis, follow the overlay instructions supplied with the same release; do not combine files from different versions.

Continue with Operations and upgrades.