Encourage the use ob abstract sockets.

pull/11/head
Joshua Potter 2023-12-01 10:06:17 -07:00
parent 383ada8661
commit 42e71e6493
2 changed files with 17 additions and 13 deletions

View File

@ -10,18 +10,20 @@ $> nix develop
## Quickstart ## Quickstart
An empty Postgres cluster is initialized at `/data`. To start the database, run An empty Postgres cluster is initialized at `/db`. To start the database, run
the following: the following:
```bash ```bash
$> pg_ctl start -o --unix_socket_directories="$PWD/data" $> pg_ctl -D db -l db/logfile -o --unix_socket_directories=@phoenix start
``` ```
To shut the database down, run: In the above command, `@phoenix` refers to an [abstract socket name](https://www.postgresql.org/docs/15/runtime-config-connection.html#GUC-UNIX-SOCKET-DIRECTORIES).
Rename to whatever is appropriate for your use case. To then connect to this
database instance, run:
```bash ```bash
$> pg_ctl stop $> psql -h @phoenix
``` ```
You can connect to this database from the project root directory by running: To later shut the database down, run:
```bash ```bash
$> psql -h "$PWD/data" -d postgres $> pg_ctl -D db stop
``` ```
Afterward, you can run the Phoenix setup commands: Afterward, you can run the Phoenix setup commands:
@ -39,7 +41,7 @@ $> mix phx.server
This project pins Mix dependencies using [mix2nix](https://github.com/ydlr/mix2nix). This project pins Mix dependencies using [mix2nix](https://github.com/ydlr/mix2nix).
After updating your `mix.lock` file, make sure to re-run the following: After updating your `mix.lock` file, make sure to re-run the following:
```bash ```bash
mix2nix > deps.nix $> mix2nix > deps.nix
``` ```
As of now, `mix2nix` cannot handle git dependencies found inside the `mix.lock` As of now, `mix2nix` cannot handle git dependencies found inside the `mix.lock`
file. If you have git dependencies, add them manually or use file. If you have git dependencies, add them manually or use

View File

@ -10,16 +10,18 @@ $> nix develop
## Quickstart ## Quickstart
An empty Postgres cluster is initialized at `/data`. To start the database, run An empty Postgres cluster is initialized at `/db`. To start the database, run
the following: the following:
```bash ```bash
$> pg_ctl start -o --unix_socket_directories="$PWD/data" $> pg_ctl -D db -l db/logfile -o --unix_socket_directories=@postgres start
``` ```
To shut the database down, run: In the above command, `@postgres` refers to an [abstract socket name](https://www.postgresql.org/docs/15/runtime-config-connection.html#GUC-UNIX-SOCKET-DIRECTORIES).
Rename to whatever is appropriate for your use case. To then connect to this
database instance, run:
```bash ```bash
$> pg_ctl stop $> psql -h @postgres
``` ```
You can connect to this database from the project root directory by running: To later shut the database down, run:
```bash ```bash
$> psql -h "$PWD/data" -d postgres $> pg_ctl -D db stop
``` ```