Deployment

Welcome to Dashy, so glad you're here :) Deployment is super easy, and there are several methods available depending on what type of system you're using. If you're self-hosting, then deploying with Docker (or similar container engine) is the recommended approach.

Quick Start

If you want to skip the fuss, and get straight down to it, then you can spin up a new instance of Dashy by running:

docker run -p 8080:8080 lissy93/dashy

See Management Docs for info about securing, monitoring, updating, health checks, auto starting, web server configuration, etc

Once you've got Dashy up and running, you'll want to configure it with your own content, for this you can reference the configuring docs.

Deployment Methods

• Docker
  • Docker Run
  • Docker Compose
  • Podman
• Bare Metal
  • Build from Source
  • Pre-Built Release
• Self-Hosted Operating Systems
  • TrueNAS SCALE
  • Proxmox VE
  • Unraid
  • Synology NAS
  • NixOS
  • Kubernetes
• Self-Hosted Platforms
  • Portainer
  • Coolify
  • 1Panel
  • Runtipi
  • Cosmos Cloud
  • CasaOS
  • Umbrel
  • EasyPanel
  • Saltbox
• Cloud Services
  • Static Hosting Providers
    • Netlify
    • Vercel
    • EdgeOne Pages
    • Cloudflare Pages
    • Firebase Hosting
    • Azure Static Web Apps
  • Container Runtimes
    • Render
    • Railway
    • Fly.io
    • Koyeb
    • Northflank
    • DigitalOcean App Platform
    • Azure Container Apps
    • Google Cloud Run
  • Managed Hosting
  • Hosting with any CDN
  • Other VPS

---

Requirements

Architecture

The pre-built Docker image runs on amd64, arm64 and armv7 (armv6 is not supported).

System Resources

• CPU: any single core, x86-64 or ARM
• RAM: Node server idles around ~80-120 MB; 256 MB is comfortable, works in less
• Disk: ~250 MB for the image + whatever your config/icons need
• Runs fine on a Pi 3 and up

Bare Metal

Requires Node.js (20+) and Yarn

CDN / Cloud Deploy

No specific requirements. The built app (without the Node server) is very lightweight and can be served by any static host or CDN. If you're using custom icons or other assets, additional disk space will be needed.

Browser Support

JavaScript is required. Dashy targets browsers with >1% global usage and the last 2 versions of each (via browserslist). In practice, any modern browser works fine. Internet Explorer is not supported.

Browser	Minimum Version	Status
Chrome / Chromium	90+	Fully supported
Firefox	90+	Fully supported
Edge	90+	Fully supported
Safari	14+	Mostly Supported
Opera	76+	Supported
Samsung Internet	15+	Supported
Firefox ESR	Latest	Supported
Internet Explorer	-	Not supported