Stackyard

Stackyard

Docker app from Stackyard

A self-hosted homelab dashboard you actually want to look at. Most dashboards are a wall of numbers and charts.

Overview
A self-hosted homelab dashboard you actually want to look at.

Most dashboards are a wall of numbers and charts. Stackyard is the opposite: a calm, launcher-style grid of app tiles, folders, and a small number of genuinely useful widgets. Built to be glanced at a hundred times a day without feeling cluttered.

Everything is set up from the browser. Add app tiles, group them into folders, arrange pages, and drop in widgets for the services you already run. Widgets cover Docker, system health, downloads, media, backups, network and more.

Runs as one container with no external database and no runtime dependencies. Configuration and uploaded icons persist in the two paths below.

Note: most homelab services live on private addresses. The Allow Private IPs setting below is on by default so links and widgets pointing at your other containers work. Turn it off to keep the SSRF guard enabled.

Stackyard

A self-hosted homelab dashboard you actually want to look at.

ghcr.io Latest release Tests Status OpenSSF Best Practices

Stackyard dashboard

Try it: demo.sandobserver.com

Most dashboards are a wall of numbers and charts. Stackyard is the opposite: a calm, launcher-style grid of app tiles, folders, and a small number of genuinely useful widgets, running in a single container. Built to be glanced at a hundred times a day without feeling cluttered.

Documentation: stackyard.sandobserver.com/docs

Why Stackyard

  • Attention goes where it's needed, not everywhere at once. A calm grid, no charts or counters. Health badges only appear when something's wrong.
  • A glance should tell you more than a number would. Widgets are small visuals, not readouts.
  • Anything can be a badge. Point Stackyard at any API and show what it reports as a live activity badge. One poll can carry several labelled values, each with its own colour and threshold. No custom widget, no code.
  • Configured by clicking, not by editing files. Everything is set up in the web UI, with config import and export.
  • No runtime npm dependencies. The image adds only nginx and supervisor, from Alpine, to the official Node base.
  • Six languages, right-to-left included. Contrast and screen-reader labels are covered by tests.
  • Installs like an app. A mobile layout that opens in its own window from a home screen. No offline mode: every tile is live.

Widgets

Widgets and the services they read:

  • Clock
  • Now Playing: Plex, Jellyfin, Emby, Navidrome
  • Weather: Open-Meteo (no API key required) or OpenWeather (free API key), with UV and air quality warnings
  • DNS: AdGuard, Pi-hole, Technitium, NextDNS
  • GitHub: contribution graph and pull requests
  • Books: Audiobookshelf, Komga, Kavita
  • System summary: CPU, memory, disk, throughput, uptime, and network speed from SpeedTest Tracker or MySpeed. Reports on this machine, or on a host running Glances, Beszel, the Unraid API, Proxmox VE or TrueNAS
  • Disk health: TrueNAS, Unraid, Scrutiny
  • Backup: Duplicati, Kopia, Proxmox Backup Server, Backrest 1.14 or newer
  • Downloads: qBittorrent, Transmission, Deluge, SABnzbd, NZBGet
  • Up Next: the next episodes, films and albums from Sonarr, Radarr and Lidarr
  • Connections: Gluetun, Psiphon Conduit, Netbird, Plausible, Umami
  • Dashboard switch: links to your other Stackyard dashboards

Each widget is documented at Widgets. Adding one is a folder, with no changes to the rest of the app; see Build your first widget.

Getting started

You need Docker.

services:
  stackyard:
    image: ghcr.io/sandobserver/stackyard:latest
    container_name: stackyard
    restart: unless-stopped
    ports:
      - "8700:80"
    volumes:
      - data:/data
      - icons:/icons

volumes:
  data:
  icons:
docker compose up -d

Then open http://localhost:8700 and set everything up at /admin. Config and uploaded icons persist in the two volumes.

On Unraid, install it from Community Apps.

On TrueNAS, install it from the Apps catalog.

The same image is on Docker Hub as sandobserver/stackyard. Prefer ghcr.io: it is the registry the release signature covers.

The repo's docker-compose.yml is the recommended version: it adds resource limits, dropped capabilities, and commented options for a reverse proxy, host access, and Docker health checks.

Full instructions, including building from source, are at Installation.

Documentation

Security

Stackyard never returns stored secrets to the browser, guards the URLs you test in the admin UI against SSRF and pins the resolved IP, and bounds every upstream call so one slow service cannot hang the dashboard. Some features trade safety for convenience and are opt-in with warnings. Read Security before exposing Stackyard beyond your LAN.

Accessibility

Stackyard targets WCAG 2.2 level AA and is partially conformant. What is supported, the known limitations, and how this was assessed are in ACCESSIBILITY.md.

Contributing

Contributions are welcome, within the constraints that keep Stackyard small and auditable (one container, no backend dependencies, vanilla frontend). See Contributing. Participation is covered by the Code of Conduct. Who maintains Stackyard and how decisions are made is in GOVERNANCE.md.

Changelog

Notable changes are listed in CHANGELOG.md; per-release notes are on the GitHub Releases page.

License

Licensed under the Apache License 2.0. You are free to use, modify, fork, and build on Stackyard, including commercially. In return you must keep the existing copyright and attribution notices, and the license does not grant rights to the Stackyard name or logo: forks are welcome but must use their own name and not present themselves as the original project. See NOTICE.

Media gallery

1 / 5

Categories

Download Statistics

5,117
Total Downloads

Related apps

Explore more like this

Explore all

Links

Details

Repository
ghcr.io/sandobserver/stackyard:latest
Last Updated2026-11-10
First Seen2026-08-17

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Privileged
false
Extra Params
--user=0:0 --init --cap-drop=ALL --cap-add=NET_BIND_SERVICE --cap-add=CHOWN --cap-add=SETUID --cap-add=SETGID --cap-add=DAC_OVERRIDE --cap-add=KILL --security-opt=no-new-privileges:true --pids-limit=256 --memory=384m --memory-reservation=96m --memory-swap=384m --cpus=0.5

Template configuration

WebUI PortPorttcp

Port the dashboard is reached on.

Target
80
Default
8700
Value
8700
Config StoragePathrw

Dashboard configuration. Keep this, or every setting is lost on update.

Target
/data
Default
/mnt/user/appdata/stackyard/data
Value
/mnt/user/appdata/stackyard/data
Icon StoragePathrw

Icons you upload for your app tiles.

Target
/icons
Default
/mnt/user/appdata/stackyard/icons
Value
/mnt/user/appdata/stackyard/icons
Allow Private IPsVariable

Let widgets and badges reach private addresses, which most homelab services use. Set to false to keep the SSRF guard on.

Target
ALLOW_PRIVATE_IPS
Default
true
Value
true
Docker Socket Proxy URLVariable

Optional. Address of a Docker socket proxy, for the Docker widgets. Example: http://socket-proxy:2375

Target
SOCKET_PROXY_URL
Trust ProxyVariable

Optional. Set to true behind a reverse proxy that terminates HTTPS, so the sign-in cookie is marked HTTPS-only.

Target
TRUST_PROXY
Node OptionsVariable

Node heap cap. Keep it near half the --memory limit in Extra Parameters, and raise both together.

Target
NODE_OPTIONS
Default
--max-old-space-size=192
Value
--max-old-space-size=192