Skip to main content
Scalple
Scalple
Self-hosted

Install Scalple
on your infrastructure.

Pre-built Docker images. Choose Docker Compose for single servers or Kubernetes for multi-node, high-availability deployments.

Choose your deployment
Docker installation
1Quick install
Quick install
curl -fsSL https://scalple.com/install/docker/install.sh | bash

Checks Docker + Compose, asks for your domain and identity provider credentials. Generates all secrets automatically, writes .env and docker-compose.yml, pulls images, and starts services.

2Verified install (recommended for production)
Verified install (recommended for production)
curl -fsSL https://scalple.com/install/docker/install.sh -o install.sh
curl -fsSL https://scalple.com/install/docker/install.sh.sha256 | sha256sum -c
bash install.sh

Download the installer, verify its SHA-256 checksum, then run. Use this before piping scripts into bash on production systems.

3Manual install
Manual install
# 1. Download files
mkdir scalpel && cd scalpel
curl -fsSL https://scalple.com/install/docker/docker-compose.yml -o docker-compose.yml
curl -fsSL https://scalple.com/install/docker/Caddyfile -o Caddyfile

# 2. Edit environment variables in docker-compose.yml

# 3. Start
docker compose pull
docker compose up -d

Download the compose file and Caddyfile directly, configure environment variables, then pull and start.

4Upgrade
Upgrade
# Using the installer
./install.sh upgrade

# Or manually
docker compose pull && docker compose up -d

Pull latest images and restart. Zero-downtime rolling update.

Architecture
Scalple Docker deployment architecture
Activate your license

License key required

Scalple runs on the FREE tier until a license key is applied. Contact our team to request a license. On startup, Scalple calls our license server (URL baked into the image — cannot be overridden) to validate it. The license server is our intellectual property and is not part of your deployment.

1Contact our team to request a license key for your deployment
2Log in to your Scalple instance as Super Admin
3Navigate to Super Admin → License in the sidebar
4Paste your license key into the input field
5Click Save — Scalple validates against our license server (operated by us, not deployed on your infrastructure)
Included in every deployment
Zero credential exposure

Full policy engine. Credentials stay in Scalple's encrypted vault, never exposed to developers.

Immutable audit trail

INSERT-only audit log for every query, access request, and denial. Tamper-evident by schema design.

PostgreSQL · MySQL · MongoDB

Connect any of the three major engines. Credentials remain encrypted at rest.

EU-only cloud

AWS excluded. CLOUD Act jurisdiction avoided. Data sovereignty guaranteed.

Sandboxed TypeScript

V8 Isolates with hard resource limits. No arbitrary code execution on your infrastructure.

License validation

Validated on startup against our license server. Request a key from our team — no self-hosted license server required.

Book a demo

Need help with your deployment? Contact our team.

Self-hosted install — frequently asked questions

What are the minimum system requirements for self-hosted Scalple?

Minimum: 2 vCPUs, 4 GB RAM, 20 GB disk, Docker 24+, and Docker Compose v2. For production deployments under sustained query load, 4 vCPUs and 8 GB RAM are recommended. The V8 Isolate sandbox for TypeScript query execution is memory-intensive — each concurrent query uses up to 128 MB. Kubernetes deployments should configure resource requests and limits accordingly on the query-executor pod.

Can I run Scalple on AWS?

Technically yes, but not recommended for GDPR compliance. AWS is subject to the US CLOUD Act, which allows US law enforcement to compel data disclosure from US-domiciled companies regardless of where the data is stored. An EU customer's data on AWS Frankfurt can be subject to a US government order. For GDPR data sovereignty, deploy Scalple on EU-domiciled providers not subject to CLOUD Act jurisdiction: Hetzner Cloud (Germany), OVHcloud (France), Exoscale (Austria/Switzerland), or Scaleway (France).

Does Scalple support Kubernetes?

Yes. The Kubernetes install path uses a Helm chart targeting Kubernetes 1.27+. It includes Deployments for the API server, query executor, and audit log writer, a PersistentVolumeClaim for audit log storage, and optional Horizontal Pod Autoscaler configuration for the query-executor Deployment. The query executor is stateless and scales horizontally. The audit log writer is stateful and should run as a single replica with a persistent volume.

What databases does self-hosted Scalple connect to?

PostgreSQL 13 and later, MySQL 8.0 and later, MongoDB 5.0 and later, and Redis 7.0 and later. MariaDB 10.6+ is supported on the MySQL connection path. Connections are configured via the Scalple admin UI — no database-side changes are required beyond creating a dedicated Scalple database user with the minimum required permissions. Connection credentials are stored encrypted in Scalple's vault, never on developer machines.

How do I upgrade Scalple to a new version?

For Docker Compose deployments: run 'docker compose pull && docker compose up -d'. Database schema migrations execute automatically on startup. For Kubernetes: run 'helm upgrade scalple scalple/scalple --reuse-values'. Scalple follows semantic versioning. Minor and patch upgrades are backward-compatible. Major version upgrades include a migration guide. The running version and available updates are displayed in the Scalple admin panel.