Stirling-PDF — a locally hosted web app with 50+ tools to manipulate PDFs: merge, split, convert, OCR, sign, compress, and more. Everything runs on your server; nothing is sent out. Deployed as a host-networked Nomad service.
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "stirling-pdf"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Stirling-PDF container image. Use a `-fat` tag if you need OCR/extra features. Pin a tag in production.
image = "stirlingtools/stirling-pdf:latest"
# Host port for the web UI. Default 8096 (the app listens on 8080 by default; set via SERVER_PORT).
port = 8096
# Enable Stirling-PDF's built-in login/user management. When true, set an initial admin via env in the rendered job or the first-run flow. Default false = open (keep it internal).
enable_login = false
# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
# The task resources. Raise memory for OCR / large PDFs.
resources = {
cpu = 1000
memory = 1024
}
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "stirling-pdf" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "stirlingtools/stirling-pdf:latest" | The Stirling-PDF container image. Use a `-fat` tag if you need OCR/extra features. Pin a tag in production. |
| port | number | 8096 | Host port for the web UI. Default 8096 (the app listens on 8080 by default; set via SERVER_PORT). |
| enable_login | bool | false | Enable Stirling-PDF's built-in login/user management. When true, set an initial admin via env in the rendered job or the first-run flow. Default false = open (keep it internal). |
| constraints | list | [] | Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
| resources | object | {
cpu = 1000
memory = 1024
} | The task resources. Raise memory for OCR / large PDFs. |
No variables match.
Stirling-PDF — a locally hosted web app with 50+ tools to work with PDFs: merge, split, rotate, convert, OCR, sign, watermark, compress, and more. Everything runs on your server — uploaded files aren't sent anywhere. Host-networked Nomad service.
nomad-pack registry add nomploy github.com/Nomploy/nomad-packs
nomad-pack run stirling-pdf --registry nomploy
In nomploy: create a Compose service, type Nomad Pack, pack stirling-pdf, custom
registry github.com/Nomploy/nomad-packs, then Deploy.
Open http://<node-ip>:8096.
| Variable | Default | Notes |
|---|---|---|
image |
stirlingtools/stirling-pdf:latest |
Use a -fat tag for OCR/extra features. Pin in production. |
port |
8096 |
Web UI host port (SERVER_PORT). |
enable_login |
false |
Turn on Stirling's login/user management. |
constraints |
[] |
Placement. |
resources |
cpu 1000 / mem 1024 |
Raise memory for OCR / large PDFs. |
/configs, /usr/share/tessdata, and
/pipeline mounts enable custom settings, extra OCR languages, and automation; add them
if you need those.)enable_login off it's open — keep it internal or front it with an
authenticating reverse proxy.