Grist — a modern relational spreadsheet: the flexibility of a spreadsheet with the structure of a database, plus Python formulas, dashboards, and access rules. Deployed as a single host-networked Nomad service on SQLite with a persistent /persist volume.
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "grist"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Grist container image. Pin a tag in production.
image = "gristlabs/grist:latest"
# Host port for the Grist web UI (PORT).
port = 8484
# Secret used to sign session cookies (GRIST_SESSION_SECRET). Set a long random value.
session_secret = "change-me-to-a-long-random-session-secret"
# Email of the initial admin/owner (GRIST_DEFAULT_EMAIL). Empty = not set.
default_email = ""
# Public base URL Grist is served at (APP_HOME_URL), e.g. http://<host>:8484. Empty = not set.
app_home_url = ""
# Named volume for Grist documents and its SQLite metadata (/persist).
data_volume = "grist_data"
# Placement constraints. Pin to the node holding the volume. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
# The task resources.
resources = {
cpu = 500
memory = 512
}
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "grist" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "gristlabs/grist:latest" | The Grist container image. Pin a tag in production. |
| port | number | 8484 | Host port for the Grist web UI (PORT). |
| session_secret set me | string | "change-me-to-a-long-random-session-secret" | Secret used to sign session cookies (GRIST_SESSION_SECRET). Set a long random value. |
| default_email | string | "" | Email of the initial admin/owner (GRIST_DEFAULT_EMAIL). Empty = not set. |
| app_home_url | string | "" | Public base URL Grist is served at (APP_HOME_URL), e.g. http://<host>:8484. Empty = not set. |
| data_volume | string | "grist_data" | Named volume for Grist documents and its SQLite metadata (/persist). |
| constraints | list | [] | Placement constraints. Pin to the node holding the volume. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
| resources | object | {
cpu = 500
memory = 512
} | The task resources. |
No variables match.
Grist — a modern relational spreadsheet: the flexibility of a spreadsheet with the structure of a database, plus Python formulas, dashboards, and fine-grained access rules.
Single host-networked Nomad service on SQLite with a persistent /persist volume.
nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run grist --registry=nomploy
| Variable | Default | Description |
|---|---|---|
port |
8484 |
Web UI port (PORT). |
session_secret |
placeholder | GRIST_SESSION_SECRET — set a long random value. |
default_email |
"" |
GRIST_DEFAULT_EMAIL — makes this account the initial owner. |
app_home_url |
"" |
APP_HOME_URL — public base URL (for a reverse proxy). |
data_volume |
grist_data |
/persist — documents + SQLite metadata. |
image |
gristlabs/grist:latest |
Container image. Pin a tag in production. |
resources |
{ cpu = 500, memory = 512 } |
Task resources. |
Documents live on the /persist volume — back it up and pin the job to that node with
constraints.