podlets

My personal podman podlets configs

Setup with GNU Stow

This repo uses GNU stow to symlink container definitions into the correct XDG location.

# Install stow (if not already present)
sudo dnf install stow # Fedora
sudo apt install stow # Debian/Ubuntu
# From the repo root, stow the containers directory
stow --dir=. --target=$HOME containers
# This symlinks containers/.config → ~/.config,
# so systemd picks up the podlet unit files automatically.
# Create the data path for volume data
mkdir -p ~/.local/share/{timetagger,paperless}
# Reload systemd to pick up the new containers
systemctl --user daemon-reload

Verification

# List the symlinked files
ls -l ~/.config/containers/systemd/
# Check a unit status
systemctl --user status paperless-ngx-pod

Caddy Config for .local services

Timetagger

timetagger.local {
 tls internal
 reverse_proxy 127.0.0.1:8091
}

Paperless-ngx

paperless.local {
 tls internal
 reverse_proxy 127.0.0.1:8095
}

Data Backup

Container volumes live under ~/.local/share/<service>/. Use the provided justfile to archive each service's data into a separate tarball:

# Backup all services (one tar per service) into ./backups/
just backup
# Or back up a single service
just backup-paperless-ngx
just backup-timetagger

Backups are stored as backups/<service>-<YYYY-MM-DD>.tar.gz by default.