Quickstart: self-hosted
From clone to running container to first digest, copy and paste
You need Docker with Compose and an Anthropic API key. Everything a setting means is on Configuration; other LLM options, including a free local Ollama, are on LLM providers.
Clone and create the env file
git clone https://github.com/esmeepeters/owlypost.git
cd owlypost
cp .env.example .envSet the two required values
openssl rand -base64 24 # use the output as POSTGRES_PASSWORDPOSTGRES_PASSWORD=paste-the-generated-value
ANTHROPIC_API_KEY=sk-ant-...Start the stack
docker compose up -d
docker compose pspostgres is healthy, migrate has exited with code 0, app and worker are running.
Add a source and generate a digest
Open http://localhost:3000. On Sources, paste any newsletter, blog, YouTube channel or podcast URL, press Detect feed, then Add source, then Fetch now. On Digests, press Generate digest now.
When the first digest arrives
The manual run finishes within a minute or two; refresh the Digests page. From then on the
digest is written weekly on Sunday at 17:00 UTC until you change the slot under Settings
and set DIGEST_TIMEZONE in .env. See Scheduling.