Guides for running nomploy — a self-hostable PaaS that deploys your apps and databases onto a HashiCorp Nomad cluster.
New here? Start with Getting Started, then come back for the topic you need.
| Guide | What it covers |
|---|---|
| Getting Started | Install on a fresh VPS, first login, deploy your first app. |
| Architecture | How nomploy maps to Nomad, Consul, Traefik and the WireGuard overlay. |
| Cluster management | Grow to a highly-available multi-node cluster: add/remove servers and workers, drain nodes, DNS health. |
| Deploying | Compose → Nomad HCL, native Nomad job files, and Nomad Pack. |
| Autoscaling | Horizontal autoscaling for applications and compose services. |
| Load Balancer | HA Traefik pool, DNS health-prune, shared certs, metrics & logs tabs. |
| Telemetry | Built-in OpenTelemetry Collector → any OTLP backend (SigNoz, Grafana, Datadog); service auto-discovery and signal toggles. |
| Monitoring & Alerts | Metric alert rules (LB, service, and security/observability health) → cluster-alert notifications, with silences. |
| Security | Built-in CrowdSec: detect malicious traffic and block offending IPs at the ingress (detection vs enforce, anti-lockout). |
| Container registry | One-click self-hosted zot+S3/R2, or run your own + Add Registry; credentials distributed cluster-wide. |
| Overview | Org-wide dashboard aggregating services, domains, backups and deployments across every project. |
| Infrastructure as Code | Manage services as code with the Pulumi provider, over the REST API. |
| GPU workloads | Requesting NVIDIA GPUs for a job. |
- Install:
curl -sSL https://nomploy.com/install.sh | sh - Image:
ghcr.io/nomploy/nomploy(override withNOMPLOY_IMAGE=…) - License: AGPL-3.0 (portions Apache-2.0). See
../LICENSING.md.
If something here doesn't match what you see in the UI, the code is the source of truth — please open an issue.