aboutsummaryrefslogtreecommitdiff
path: root/README
blob: a4aa7c0629083609ed1231b4882514a4c27c7116 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
ppq - Portable PostgreSQL
=========================

This allows running PostgreSQL locally without having to set up a
system-wide service. It is portable in the sense that you can move the
directory around, and you can run multiple instances side-by-side.

It serves as a good basis to use as a development environment, for
projects that require a Postgres server.

How to use
----------

The best way to run this project is with Nix and direnv.  You don't
need NixOS.

Simply cd into the directory, and direnv should take care of the rest.
Then you can run a Postgres server with `./ppq start`.

All Postgres client programs (like `psql`, `pg_restore` etc) are
available and environment variables like `PGUSER` and `PGHOST` are set
up to ensure it will talk to the local Postgres server automatically.