Files
codeandClaude Fable 5 8ab413804a normalize all stacks to conventions
- VOL_PATH always defaults to /data; vscode/opencode VOL_PROJECTS nests it
- TZ defaults to America/Vancouver (was UTC in etherpad, ntfy, redis)
- compose section order fixed (volumes before environment, command after networks)
- all default secrets are the literal ChangeThisPassword (grep-friendly,
  users must change them); removed a real key from ollama sample.env
- sample.env synced with compose: missing vars added with defaults, dead vars removed
- invoiceninja_dev/openarchiver_dev: app services had no environment block,
  wired all sample.env vars through so the stacks actually work
- opencode: sample.env OLLAMA_HOST renamed to OLLAMA_HOST_URL to match compose
- TZ values unquoted consistently

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 06:24:54 +00:00
..
2026-07-16 06:24:54 +00:00

YOURLS

Overview

YOURLS (Your Own URL Shortener) is a self-hosted URL shortener with link statistics, a bookmarklet, and a plugin API. This stack runs YOURLS with a MariaDB database.

Project Details

Getting Started

  1. Copy sample.env and set YOURLS_SITE, the admin login, and the database passwords
  2. Start the containers: docker compose up -d
  3. Open http://localhost:8080/admin/ in your browser and run the install step, then sign in with YOURLS_USER / YOURLS_PASS

Environment Variable Notes

YOURLS_SITE  public base URL used in generated short links; must
  match how users reach the site (domain behind the proxy)
YOURLS_USER / YOURLS_PASS  admin login for the /admin/ interface
YOURLS_DB_NAME / YOURLS_DB_USER / YOURLS_DB_PASSWORD  database
  name and credentials, shared by both services
YOURLS_MYSQL_ROOT_PASSWORD  MariaDB root password
YOURLS_PORT  host port for the web UI (default 8080)

Volume Notes

  • /var/www/html — YOURLS application files and plugins; stored at ${VOL_PATH:-/data}/yourls/html on the host
  • /var/lib/mysql — MariaDB data; stored at ${VOL_PATH:-/data}/yourls/db on the host

Network Notes

Requires proxy network. The database is only attached to the stack's internal network.

Docker Run

Not recommended — YOURLS needs its MariaDB companion. Use the compose file.

Additional Notes / Gotchas

  • This is a _dev stack — experimental, not yet production-ready.
  • The admin interface is at /admin/, not the site root.
  • Changing YOURLS_SITE after install does not rewrite existing short links; set it correctly before creating links.

Dockhand Stack, Deploy from Git

  • Cookbooks Repository
  • stackname: yourls_dev
  • Compose file path: yourls_dev/compose.yaml
  • Additional env file (optional): yourls_dev/sample.env

Then "Load" yourls_dev/sample.env into the Environment variables in dockhand.

Create the Stack