docs(setup): add psql and redis-cli to prerequisites #61

Merged

julien merged 1 commits from docs/setup/db-clients-in-prereqs into main 2026-05-08 22:05:06 +02:00

Conversation 0 Commits 1 Files Changed 1

+12 -10

julien commented 2026-05-08 22:04:52 +02:00

Owner

Copy Link

Copy Source

Summary

Verifying the local-dev stack from the host (docker compose up -d + psql ... -c "\du" / redis-cli PING) requires the postgres and redis client binaries on the developer's machine. They were missing from the prereqs table, so apt install postgresql-client / apt install redis-tools was an implicit step nobody knew to run.

Add both to §2's table, with one-line rationale for each. The Docker row is also tightened to point at the actual local-dev stack location (infra/local/) instead of the placeholder "Postgres + Redis containers" wording from before that recipe existed.

docker compose exec remains a viable zero-install alternative for developers who prefer not to touch their host. Mentioned only informally — the host-install path is the documented one.

Test plan

• Fresh-clone a checkout, follow §2 + §3 verbatim, end with a working stack and successful psql ... -c "\du" against it.

## Summary Verifying the local-dev stack from the host (`docker compose up -d` + `psql ... -c "\du"` / `redis-cli PING`) requires the postgres and redis client binaries on the developer's machine. They were missing from the prereqs table, so `apt install postgresql-client` / `apt install redis-tools` was an implicit step nobody knew to run. Add both to §2's table, with one-line rationale for each. The Docker row is also tightened to point at the actual local-dev stack location ([`infra/local/`](infra/local/)) instead of the placeholder "Postgres + Redis containers" wording from before that recipe existed. `docker compose exec` remains a viable zero-install alternative for developers who prefer not to touch their host. Mentioned only informally — the host-install path is the documented one. ## Test plan - [ ] Fresh-clone a checkout, follow §2 + §3 verbatim, end with a working stack and successful `psql ... -c "\du"` against it.

julien added 1 commit 2026-05-08 22:04:52 +02:00

docs(setup): add psql and redis-cli to prerequisites ... 3f2d36d226

Verifying the local-dev stack from the host (`docker compose up -d`
+ `psql ... -c "\du"`, `redis-cli PING`) requires the postgres and
redis client binaries on the developer's machine. They were missing
from the prereqs table, so `apt install postgresql-client` /
`apt install redis-tools` was an implicit step nobody knew to run.

Add both to §2's table, with one-line rationale for each. The
Docker row is also tightened to point at the actual local-dev
stack location (`infra/local/`) instead of the placeholder
"Postgres + Redis containers" wording from before that recipe
existed.

`docker compose exec` remains a viable zero-install alternative
when a developer prefers not to touch their host (mentioned only
informally — the host-install path is the documented one).

julien merged commit a93b1067e6 into main 2026-05-08 22:05:06 +02:00

julien deleted branch docs/setup/db-clients-in-prereqs 2026-05-08 22:05:09 +02:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

adastra-bot (AdAstra Bot) julien (Julien Gautier)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: julien/apf_portal#61