Deckle

Overview

A morning newspaper for your e-reader, built on your server. Deckle sets a real paper from your town's news and weather, your RSS feeds and the articles you saved, with a front page, sections and a puzzle, and has it waiting on your Kindle or KOReader before you're up. This is the headless container. It builds the Daily on the schedule you set, keeps every edition in a Morgue folder, and delivers it by email to a Kindle (through your own mail account), over Wi-Fi to KOReader, or to any folder. The Deckle app runs in your browser on port 8080 once you set a web UI password; without one, only the schedule runs. FIRST START: Deckle writes a starter digest.toml in the Config folder. Edit it in the web UI's Daily tab, or edit the file and restart the container. Put the Kindle email password in the Kindle email password field: the container has no keychain. NOT IN THE CONTAINER: Kindle book conversion (Enhanced Typesetting, X-Ray, Word Wise) needs Kindle Previewer, which only runs on Mac and Windows. Use the desktop app for books. The web UI speaks plain HTTP. Beyond your home network, put it behind a reverse proxy with TLS. Setup: https://github.com/CasaVargas/deckle/blob/main/docs/docker.md

Readme

View on GitHub

Deckle for Unraid

The Unraid Community Applications template for Deckle, a morning newspaper for your e-reader. Every morning it sets a real paper from your town's news and weather, your RSS feeds and the articles you saved, and has it waiting on your Kindle or KOReader before you're up.

Deckle · Container guide · Support

Three pages of a demo edition on e-readers: a story with a photo, the weather page, and the mini crossword

Install

Apps tab, search Deckle, then:

Pick your TZ. Papers print on that zone's clock.
Set a Web UI password (12 or more characters). Without one the web UI stays off and only the schedule runs.
To email the paper to a Kindle, fill in Kindle email password.
Apply, then open the WebUI on port 8080.

The first start writes a starter digest.toml in /config/deckle. Set your town, feeds, the morning time and delivery in the web UI's Daily tab.

The two paths

Mount	Holds	Default
`/config`	`digest.toml`, papers, state	`/mnt/user/appdata/deckle`
`/data`	`Deckle/`: the Morgue, Inbox, uploads, exports	`/mnt/user/deckle`

Optional ports

Under Show more settings. KOReader over Wi-Fi and the calibre connection stay off until you turn them on in the Daily tab's Delivery.

Port	For
47219	The bookmarklet: save a page to tomorrow's paper. Set Bookmarklet address too.
47220	KOReader over Wi-Fi: the paper and your books in KOReader's catalog. Set KOReader over Wi-Fi address too.
9090	KOReader's calibre connection. Readers find it by themselves only with Network Type: host.

Worth knowing

No Kindle book conversion. Enhanced Typesetting, X-Ray and Word Wise need Kindle Previewer, which only runs on Mac and Windows. The paper builds without it.
Kindle by email only. There's no USB in the container. Add the from address to Amazon's Approved Personal Document E-mail List.
Plain HTTP. Beyond your home network, put the web UI behind a reverse proxy with TLS (SWAG, Nginx Proxy Manager). Never expose the bookmarklet or reader ports to the internet.

The full guide, including moving from the desktop app and running the AI editor beside Ollama, is docs/docker.md.

Keeping up

The template is edited in the Deckle repository at docker/unraid/deckle.xml and copied here. File issues at CasaVargas/deckle.

The MIT license in this repository covers these templates and docs. Deckle itself is GPL-3.0-or-later.

Media gallery

1 / 3

Requirements

Internet access to fetch the news, weather and feeds. To reach a Kindle: an email account Deckle can send from, with that address on Amazon's approved list.

Related apps

Explore more like this

Explore all

Books apps Productivity

Links

Projectgithub.com Supportgithub.com Registrygithub.com Templateraw.githubusercontent.com

Details

Repository

ghcr.io/casavargas/deckle:latest

Registry

https://github.com/CasaVargas/deckle/pkgs/container/deckle

Last Updated2026-11-09

First Seen2026-11-09

Runtime arguments

Web UI: http://[IP]:[PORT:8080]/
Network: bridge
Shell: sh
Privileged: false
Extra Params: --stop-timeout 90

Template configuration

ConfigPathrw

digest.toml, papers and state. Small; keep it on appdata.

Target: /config
Default: /mnt/user/appdata/deckle
Value: /mnt/user/appdata/deckle

DataPathrw

The Morgue, library, Inbox, uploads and export folders (Deckle/ inside).

Target: /data
Default: /mnt/user/deckle
Value: /mnt/user/deckle

PUIDVariable

User id the files are written as (99 is nobody).

Default: 99
Value: 99

PGIDVariable

Group id the files are written as (100 is users).

Default: 100
Value: 100

TZVariable

Time zone. Papers print on this zone's clock.

Default: America/New_York
Value: America/New_York

Web UI portPorttcp

The Deckle app in your browser.

Target: 8080
Default: 8080
Value: 8080

Web UI passwordVariable

The password the web UI asks for; 12 or more characters. Without one the web UI stays off and only the schedule runs.

Target: DECKLE_WEB_PASSWORD

Kindle email passwordVariable

Password for the [email] account that sends the paper to your Kindle. Leave blank if you don't email it.

Target: DECKLE_SMTP_PASSWORD

Bookmarklet portPorttcp

Optional. Lets a browser bookmarklet save pages to tomorrow's paper.

Target: 47219
Default: 47219
Value: 47219

Bookmarklet addressVariable

Optional. The address your browser reaches the bookmarklet port at, as scheme://host[:port] with no path, e.g. http://tower.local:47219.

Target: DECKLE_BOOKMARKLET_URL

KOReader over Wi-Fi portPorttcp

Optional. The reader server: the paper and your books in KOReader's catalog, and its sync. Off until you turn it on in the Daily tab's Delivery.

Target: 47220
Default: 47220
Value: 47220

KOReader over Wi-Fi addressVariable

Optional. The address your e-readers reach that port at, e.g. http://tower.local:47220, so the app shows URLs that work.

Target: DECKLE_READER_SERVER_URL

KOReader calibre portPorttcp

Optional. KOReader's calibre connection. Readers find it by themselves only with Network Type: host.

Target: 9090
Default: 9090
Value: 9090

Library

Curated

Categories