yarnl

Overview

Your self-hosted crochet companion. Manage crochet patterns, track project progress, and organize your pattern library. Supports multi-user, OIDC/SSO, scheduled backups, and more.

Requirements

PostgreSQL 16 container is required. Install the PostgreSQL template from Community Applications before installing Yarnl.

Runtime arguments

Web UI: http://[IP]:[PORT:3000]
Network: bridge
Privileged: false

Template configuration

PortPorttcp

Target: 3000
Default: 3000
Value: 3000

App DataPathrw

Location where Yarnl stores all user data including patterns, thumbnails, notes, and backups

Target: /app/users
Value: /mnt/user/appdata/yarnl/users

Backup PathPathrw

Optional: mount an external path to store backups. Set 'Use External Backup Path' to true if using this.

Target: /backups

Use External Backup PathVariable

Set to true to store backups at the mounted Backup Path volume. Leave blank to store backups in App Data.

Target: BACKUP_PATH

Admin UsernameVariable

Initial admin account username

Target: ADMIN_USERNAME
Default: admin
Value: admin

Admin PasswordVariable

Initial admin password (leave empty for passwordless login)

Target: ADMIN_PASSWORD

TimezoneVariable

Timezone for scheduled backups (e.g. America/New_York)

Target: TZ
Default: UTC
Value: UTC

Database HostVariable

Hostname of the PostgreSQL container

Target: POSTGRES_HOST
Default: yarnl-db
Value: yarnl-db

Database PortVariable

Port for the PostgreSQL database

Target: POSTGRES_PORT
Default: 5432
Value: 5432

Database NameVariable

Name of the PostgreSQL database

Target: POSTGRES_DB
Default: yarnl
Value: yarnl

Database UsernameVariable

PostgreSQL database username

Target: POSTGRES_USER
Default: yarnl
Value: yarnl

Database PasswordVariable

PostgreSQL database password

Target: POSTGRES_PASSWORD
Default: yarnl
Value: yarnl

Links

Template Support Docker Hub Project

Details

Repository

titandrive/yarnl

Registry

https://hub.docker.com/r/titandrive/yarnl/

Last Updated2026-04-15

First Seen2026-03-03

Run Yarnl on Unraid.

Yarnl is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS