Nomploy Nomad Packs

← All packs

pgweb v0.1.0

Dev tools

pgweb — a fast, lightweight, browser-based PostgreSQL client: browse tables, run queries, inspect schemas, and export results. Deployed as a stateless host-networked Nomad service in sessions mode, so each user enters their own connection in the UI. Pairs with the postgres pack.

nomad-pack run pgweb --registry nomploy

Source ↗ Project ↗ ★ 9.5k

1 task http 8081 image sosedoff/pgweb:latest
Variables 7
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run pgweb -f values.hcl --registry nomploy
# The name of the Nomad job.
job_name = "pgweb"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The pgweb container image. Pin a tag in production.
image = "sosedoff/pgweb:latest"

# Host port for the pgweb web UI.
port = 8081

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 200
    memory = 128
  }
NameTypeDefaultDescription
job_name string 
"pgweb"
 The name of the Nomad job.
namespace string 
"default"
 The Nomad namespace to deploy into.
datacenters list 
["*"]
 The datacenters to deploy to.
image string 
"sosedoff/pgweb:latest"
 The pgweb container image. Pin a tag in production.
port number 
8081
 Host port for the pgweb web UI.
constraints list 
[]
 Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources object 
{
    cpu    = 200
    memory = 128
  }
 The task resources.
Readme

pgweb

pgweb — a fast, lightweight, browser-based PostgreSQL client: browse tables, run queries, inspect schemas, and export results.

Stateless host-networked Nomad service in sessions mode, so each user enters their own connection in the UI. Pairs with the postgres pack.

Deploy

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

Configure

Variable Default Description
port 8081 Web UI port.
image sosedoff/pgweb:latest Container image. Pin a tag in production.
resources { cpu = 200, memory = 128 } Task resources.

Open the UI and connect to any reachable Postgres (a co-located postgres pack is on 127.0.0.1:5432). pgweb grants full database access — keep it internal or behind auth.