dbb-transcribe

dbb-transcribe turns a pasted URL or an uploaded file into a transcript. The page is an Astro app in apps/dbb-transcribe. Production is the only environment. The dev app was removed on 9 Nov 2026.

The host is https://transcribe.server.daz.dev. It is Tailscale-only. A client off the tailnet receives 403. It does not use dbb-auth.

The app README is apps/dbb-transcribe/README.md. Deploys and checks are in platform/transcribe.md.

Coolify

Project Platform, environment production.

Resource	Name	UUID
Application	dbb-transcribe-webapp-production	7yqpemcndl1xzsql4ussd6qh
Postgres 17.8	dbb-transcribe-db-production	buym5otpaybtv4wcvc9kt3ai

The app builds darrenbarklie/dbb-platform branch main. Base directory /apps/dbb-transcribe, Dockerfile /Dockerfile, watch paths apps/dbb-transcribe/**. It listens on port 4321. Previews are off. The database is on the coolify network only, database dbbtranscribe, and has a nightly backup at 02:00 UTC.

DBB_TRANSCRIBE_API_TOKEN is a Coolify runtime env. It is not a build arg. The value stays in Coolify.

Worker and files

Each job runs on Darren’s M1 MacBook Air over SSH. The binary is apps/dbb-transcribe/worker/dbb-transcribe-job, installed at ~/dbb-transcribe/bin/dbb-transcribe-job. There is no daemon. The web app starts it per job. Job files are under ~/dbb-transcribe/jobs/<id>.

Transcripts go to the MinIO bucket dbb-transcribe-production on dbb-minio.

Deploy

On dbb-server, from the repo root:

platform/deploy-transcribe.sh --env production

Production is the only environment the script accepts. It does not print secrets.

Health

GET /health returns 200 and {"status":"ok"} when Postgres answers. If the check fails, the response is 503 and {"status":"unavailable"}. Coolify uses that path. The checks in the runbook also confirm the Tailscale certificate and the 403 off the tailnet.