Teable — a no-code database and spreadsheet platform (an Airtable alternative) built on PostgreSQL, with grid/kanban/form views, an API and automations. Batteries-included with bundled PostgreSQL and Redis. Deployed as a single host-networked Nomad service.
Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.
Source ↗ Project ↗ ★ 21.8k ⚑ Report an issue
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "teable"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Teable container image. Pin a tag in production.
image = "ghcr.io/teableio/teable:latest"
# Host port for the Teable web UI.
port = 3000
# The PostgreSQL image for the bundled database.
postgres_image = "postgres:16"
# The Redis image for the bundled cache.
redis_image = "redis:7"
# Host port for the bundled PostgreSQL (loopback only).
db_port = 5432
# Host port for the bundled Redis (loopback only).
redis_port = 6379
# Password for the Teable database user. CHANGE THIS.
db_password = "change-me-teable-db"
# Password for the bundled Redis. CHANGE THIS.
redis_password = "change-me-teable-redis"
# Secret used to sign tokens/sessions (SECRET_KEY). CHANGE THIS. Generate with: openssl rand -base64 32.
secret_key = "change-me-openssl-rand-base64-32"
# Public URL Teable is reached at (PUBLIC_ORIGIN). Empty = http://localhost:<port>. Set to your real host/domain.
base_url = ""
# Named volume mounted at /app/.assets — uploaded attachments.
data_volume = "teable_data"
# Named volume for the PostgreSQL data directory (holds all Teable data).
db_data_volume = "teable_db"
# Resources for the PostgreSQL task.
db_resources = {
cpu = 400
memory = 512
}
# Resources for the Redis task.
redis_resources = {
cpu = 200
memory = 128
}
# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
# Resources for the Teable app task.
resources = {
cpu = 1000
memory = 1024
}
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "teable" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "ghcr.io/teableio/teable:latest" | The Teable container image. Pin a tag in production. |
| port | number | 3000 | Host port for the Teable web UI. |
| postgres_image | string | "postgres:16" | The PostgreSQL image for the bundled database. |
| redis_image | string | "redis:7" | The Redis image for the bundled cache. |
| db_port | number | 5432 | Host port for the bundled PostgreSQL (loopback only). |
| redis_port | number | 6379 | Host port for the bundled Redis (loopback only). |
| db_password set me | string | "change-me-teable-db" | Password for the Teable database user. CHANGE THIS. |
| redis_password set me | string | "change-me-teable-redis" | Password for the bundled Redis. CHANGE THIS. |
| secret_key set me | string | "change-me-openssl-rand-base64-32" | Secret used to sign tokens/sessions (SECRET_KEY). CHANGE THIS. Generate with: openssl rand -base64 32. |
| base_url | string | "" | Public URL Teable is reached at (PUBLIC_ORIGIN). Empty = http://localhost:<port>. Set to your real host/domain. |
| data_volume | string | "teable_data" | Named volume mounted at /app/.assets — uploaded attachments. |
| db_data_volume | string | "teable_db" | Named volume for the PostgreSQL data directory (holds all Teable data). |
| db_resources | object | {
cpu = 400
memory = 512
} | Resources for the PostgreSQL task. |
| redis_resources | object | {
cpu = 200
memory = 128
} | Resources for the Redis task. |
| constraints | list | [] | Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
| resources | object | {
cpu = 1000
memory = 1024
} | Resources for the Teable app task. |
No variables match.
This pack stores data in 2 Docker named volumes:
teable_dbteable_data
⚠ This pack bundles a database. A cold copy of the volume can be inconsistent — for a reliable backup, dump the DB (pg_dump / mysqldump) or stop the job while backing up.
restic
# Run on the node hosting this pack. Point restic at your repo first: # export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>" # export RESTIC_PASSWORD="<repo-password>" # export AWS_ACCESS_KEY_ID=<key> AWS_SECRET_ACCESS_KEY=<secret> restic backup \ /var/lib/docker/volumes/teable_db/_data \ /var/lib/docker/volumes/teable_data/_data
rclone (sync to S3/R2)
rclone sync /var/lib/docker/volumes/teable_db/_data backup:<bucket>/teable_db rclone sync /var/lib/docker/volumes/teable_data/_data backup:<bucket>/teable_data
Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.
Teable — a no-code database and spreadsheet platform, an Airtable alternative built on PostgreSQL. Rich field types, grid/kanban/gallery/form views, real-time collaboration, a full REST API and automations — with the scalability of a real SQL database underneath. This pack is batteries-included: the app plus bundled PostgreSQL and Redis.
Single host-networked group: teable + postgres + redis.
nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run teable --registry=nomploy
| Variable | Default | Description |
|---|---|---|
port |
3000 |
Web UI port. |
base_url |
"" |
Public URL (PUBLIC_ORIGIN). Empty = http://localhost:<port>. Set to your real host. |
secret_key |
change-me-… |
Change this. Signs tokens/sessions. openssl rand -base64 32. |
db_password / redis_password |
change-me-… |
Change these. Database and cache passwords. |
image |
ghcr.io/teableio/teable:latest |
App image. Pin a tag in production. |
postgres_image / redis_image |
postgres:16 / redis:7 |
Bundled service images. |
data_volume / db_data_volume |
… | Attachments (/app/.assets) and PostgreSQL data. |
db_port / redis_port |
5432 / 6379 |
Loopback ports for the bundled services. |
resources / db_resources / redis_resources |
… | Per-task resources. |
Teable runs database migrations automatically on start; the first account you register becomes the admin. Set
base_urlto the address users actually open. Because Postgres holds all data, pin the job to the node holding the volumes withconstraintsand back it up.