bootstrap/specs/postgres/template/README.md

Postgres Flake Template

This is a template for constructing a working environment for local Postgres (version 15.5) usage. direnv can be used to a launch a dev shell upon entering this directory (refer to .envrc). Otherwise run via:

$ nix develop

Quickstart

An empty Postgres cluster is initialized at db. To start the database, run the following:

$ pg_ctl -D db -l db/logfile -o --unix_socket_directories=@postgres start

In the above command, @postgres refers to an abstract socket name. Rename to whatever is appropriate for your use case. To then connect to this database instance, run:

$ psql -h @postgres

To later shut the database down, run:

$ pg_ctl -D db stop