Nomploy Nomad Packs

← All packs

grist v0.1.0

Apps

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.

nomad-pack run grist --registry nomploy
1 task http 8484 1 volume image gristlabs/grist:latest
Variables 11
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run grist -f values.hcl --registry nomploy
# 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
  }
NameTypeDefaultDescription
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.
Readme

grist

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.

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run grist --registry=nomploy

Configure

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.