What you'll need
Docker or Docker Desktop installed on your machine or server
To configure your first sources and topics
For the sites you want to read
Install with Docker Compose
services:
editions:
image: ghcr.io/morten-olsen/editions:latest
ports:
- "3007:3007"
volumes:
- editions-data:/data
environment:
- EDITIONS_JWT_SECRET=change-me
restart: unless-stopped
volumes:
editions-data:docker compose up -d
Then open http://localhost:3007 in your browser.
Create your account
The first person to register automatically becomes the admin. After creating your account, you can disable public registration by setting EDITIONS_ALLOW_SIGNUPS=false in your environment.
The setup flow
Add sources
Navigate to Sources and add RSS feeds for the publications you read. Each source needs a name and a feed URL.
After adding a source, click Fetch to pull in articles.
Start with 3-5 sources you actually read. You can always add more later.
Create focuses
Navigate to Focuses and create topic areas — "Technology", "Climate", "Science", whatever you care about.
The on-device ML model will automatically classify incoming articles into your focuses. Be descriptive — "Machine Learning Research" works better than "AI".
Build your first edition
Navigate to Editions and create an edition config — your magazine template.
Add focuses, set an article budget for each section, and click Generate to create your first edition.
Read your first edition
Open the generated edition. You can read it as a vertical scroll (newspaper view) or switch to the magazine view — a full-screen, paginated experience with a cover, table of contents, and an ending.
When you reach the finale page, you're done. That's the whole point.