No description

Find a file

incognitothief 965d569a52 All checks were successful Build and Deploy Shows (Docker) / build (push) Successful in 17s Details Merge pull request 'feature/add-lbox-deco' (#18 ) from feature/add-lbox-deco into main Reviewed-on: https://codeberg.org/incognitothief/shows/pulls/18		2026-06-03 06:09:57 +02:00
.forgejo/workflows	replace with alias	2026-06-02 21:09:17 -04:00
client	agent rails	2026-06-02 20:37:19 -04:00
docker	timezone select fix	2026-03-24 18:36:10 -04:00
docs	formatting	2026-06-02 21:19:26 -04:00
site	single image	2026-06-03 00:08:19 -04:00
.gitignore	consolidate documentation for bootstrapping	2026-01-29 23:13:35 -05:00
AGENTS.md	agent rails	2026-06-02 20:37:19 -04:00
CONTRIBUTING.md	consolidate documentation for bootstrapping	2026-01-29 23:13:35 -05:00
generate-env.sh	new scripts	2026-01-31 20:55:05 -05:00
package-lock.json	nodemailer	2025-12-08 21:24:25 -05:00
README.md	small updates to readme	2026-03-24 20:59:51 -04:00
run-development.sh	new scripts	2026-01-31 20:55:05 -05:00
run-docker.sh	new scripts	2026-01-31 20:55:05 -05:00
setup-env.sh	backfill ADR docs	2026-06-02 20:26:22 -04:00

Shows

A self-hosted community show flier board: public timeline, host moderation, security and privacy driven.

Quick start

Run the setup script:

./setup-env.sh          # creates .env (JWT_SECRET, optional INITIAL_HOST_EMAIL/PASSWORD, ...)

Then spin up a new container:

./run-docker.sh

The application will be available at http://localhost:3000/.

Data lives in Docker volumes shows-data and shows-uploads. Keep .env secret.

For extended config options: ./setup-env.sh --host (Docker defaults), --email (SMTP), or --all. Existing .env is merged when you re-run.

Use Docker Compose with the dev profile: backend runs with source mounted and hot reload. One container serves API + frontend at port 3000.

./setup-env.sh          # generate environment
./run-development       # run development stack (backend + db)

Logs: docker compose -f docker/docker-compose.yml --profile dev logs -f backend-dev. Stop: ... down.

Full dev workflow, repo layout, and troubleshooting → CONTRIBUTING.md.

Variable	Required	Notes
`JWT_SECRET`	Yes	Min 16 chars; use `./setup-env.sh` to generate.
`DATABASE_URL`	Yes	Default in container: `file:/app/data/shows.db`.
`INITIAL_HOST_EMAIL` / `INITIAL_HOST_PASSWORD`	First run	Seed the initial HOST user (12+ char password).
`PORT`	No	Default 3000.
`UPLOAD_STORAGE_PATH`	No	Default `/app/uploads` in Docker.
`SMTP_*`	No	Optional; for password-reset email.

Bare metal: client/deploy.sh runs migrations + seed only (no start). API details → client/API_DOCUMENTATION.md.