https://github.com/daemonless/stump
https://github.com/daemonless/stump
Last synced: 12 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/daemonless/stump
- Owner: daemonless
- Created: 2026-05-25T22:50:04.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-12T08:42:35.000Z (16 days ago)
- Last Synced: 2026-06-12T10:21:34.087Z (16 days ago)
- Language: Jinja
- Size: 1.1 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Stump
[](https://github.com/daemonless/stump/actions)
[](https://github.com/daemonless/stump/commits)
A free and open source comics, manga and digital book server with OPDS support.
| | |
|---|---|
| **Port** | 10801 |
| **Registry** | `ghcr.io/daemonless/stump` |
| **Source** | [https://github.com/stumpapp/stump](https://github.com/stumpapp/stump) |
| **Website** | [https://stumpapp.dev](https://stumpapp.dev) |
## Version Tags
| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest` | **Upstream Binary**. Built from official release. | Most users. Matches Linux Docker behavior. |
## Prerequisites
Before deploying, ensure your host environment is ready. See the [Quick Start Guide](https://daemonless.io/guides/quick-start) for host setup instructions.
## Deployment
### Podman Compose
```yaml
services:
stump:
image: ghcr.io/daemonless/stump:latest
container_name: stump
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
volumes:
- "/path/to/containers/stump:/config"
- "/path/to/containers/stump/data:/data" # optional
ports:
- 10801:10801
restart: unless-stopped
```
### AppJail Director
**.env**:
```
DIRECTOR_PROJECT=stump
PUID=1000
PGID=1000
TZ=UTC
```
**appjail-director.yml**:
```yaml
options:
- virtualnet: ': default'
- nat:
services:
stump:
name: stump
options:
- container: 'boot args:--pull'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
volumes:
- stump: /config
- stump_data: /data
volumes:
stump:
device: '/path/to/containers/stump'
stump_data:
device: '/path/to/containers/stump/data'
```
**Makejail**:
```
ARG tag=latest
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/stump:${tag}
```
### Podman CLI
```bash
podman run -d --name stump \
-p 10801:10801 \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-v /path/to/containers/stump:/config \
-v /path/to/containers/stump/data:/data # optional \
ghcr.io/daemonless/stump:latest
```
### Ansible
```yaml
- name: Deploy stump
containers.podman.podman_container:
name: stump
image: ghcr.io/daemonless/stump:latest
state: started
restart_policy: always
env:
PUID: "1000"
PGID: "1000"
TZ: "UTC"
ports:
- "10801:10801"
volumes:
- "/path/to/containers/stump:/config"
- "/path/to/containers/stump/data:/data" # optional
```
## Parameters
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `PUID` | `1000` | User ID for the application process |
| `PGID` | `1000` | Group ID for the application process |
| `TZ` | `UTC` | Timezone for the container (e.g. America/New_York) |
### Volumes
| Path | Description |
|------|-------------|
| `/config` | Configuration and database directory |
| `/data` | Media library (comics, manga, books) (Optional) |
### Ports
| Port | Protocol | Description |
|------|----------|-------------|
| `10801` | TCP | Web UI |
**Architectures:** amd64
**User:** `bsd` (UID/GID via PUID/PGID, defaults to 1000:1000)
**Base:** FreeBSD 15.0
---
Need help? Join our [Discord](https://discord.gg/Kb9tkhecZT) community.