Popularity
6.9
-
Activity
9.9
Growing
2,352
23
189

Description

Highly customizable self-hosted dashboard application.

- Status checks for monitoring your services - Optional authentication, and support for SSO - Ability to auto-fetch icons from services favicon, or use Font-Awesome or image asset - Simple to configure with YAML, or modify config directly through the UI - Instant search, custom shortcuts and web search - Workspace view, for multi-tasking and a simple startpage view - Option to open apps in a quick pop-up modal - 10+ built-in themes, plus a UI configurator to build your own - Multi-language support

Programming language: Vue
License: MIT License
Tags: Personal Dashboards     Web Apps     Docker    

Dashy alternatives and similar software solutions

Based on the "Personal Dashboards" category.
Alternatively, view dashy alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of Dashy or a related project?

Add another 'Personal Dashboards' Software solution

README

Dashy Dashy helps you organize your self-hosted services by making them accessible from a single place User Showcase | Live Demo | Getting Started | Documentation | GitHub

Contents

Features ๐ŸŒˆ

  • ๐Ÿ”Ž Instant search by name, domain, or tags + customizable hotkeys & keyboard shortcuts
  • ๐ŸŽจ Multiple built-in color themes, with UI color editor and support for custom CSS
  • ๐Ÿงธ Many icon options - Font-Awesome, homelab icons, auto-fetching Favicon, images, emojis, etc.
  • ๐Ÿšฆ Status monitoring for each of your apps/links for basic availability and uptime checking
  • ๐Ÿ“Š Use widgets to display info and dynamic content from self-hosted services
  • ๐Ÿ’‚ Optional authentication with multi-user access, configurable privileges, and SSO support
  • ๐ŸŒŽ Multi-language support, with 10+ human-translated languages, and more on the way
  • โ˜ Optional, encrypted, free off-site cloud backup and restore feature available
  • ๐Ÿ’ผ A workspace view, for easily switching between multiple apps simultaneously
  • ๐Ÿ›ฉ๏ธ A minimal view, for use as a fast-loading browser Startpage
  • ๐Ÿ–ฑ๏ธ Choose app launch method, either new tab, same tab, a pop-up modal, or in the workspace view
  • ๐Ÿ“ Customizable layout, sizes, text, component visibility, sort order, behavior, etc.
  • ๐Ÿ–ผ๏ธ Options for a full-screen background image, custom nav-bar links, HTML footer, title, etc.
  • ๐Ÿš€ Easy to setup with Docker, or on bare metal, or with 1-Click cloud deployment
  • โš™๏ธ Easy single-file YAML-based configuration, and option to configure app through the UI
  • โœจ Under active development with improvements and new features added regularly
  • ๐Ÿค Small bundle size, fully responsive UI, and PWA for basic offline access
  • ๐Ÿ†“ 100% free and open-source
  • ๐Ÿ” Strong focus on privacy
  • ๐ŸŒˆ And loads more...

Demo โšก

Live Instances: Demo 1 (Live Demo) โ”† Demo 2 (Dashy Links) โ”† Demo 3 (Dev Preview)

Screenshots: Checkout the [Showcase](./docs/showcase.md), to see example dashboards from the community

Spin up your own demo: One-Click Deploy with PWD or [docker run -p 8080:80 lissy93/dashy](./docs/quick-start.md)

โฌ†๏ธ Back to Top


Getting Started ๐Ÿ›ซ

For full setup instructions, see: [Deployment](./docs/deployment.md)

Deploying from Docker Hub ๐Ÿณ

You will need Docker installed on your system

docker run -p 8080:80 lissy93/dashy

Or

docker run -d \
  -p 4000:80 \
  -v /root/my-local-conf.yml:/app/public/conf.yml \
  --name my-dashboard \
  --restart=always \
  lissy93/dashy:latest

Dashy on Docker Hub

See also examples [with Docker Compose](./docs/deployment.md#using-docker-compose). Dashy is also available via GHCR, and tags for other architectures (arm32v7, arm64v8, etc.) and set versions are supported

Once you've got Dashy running, see [App Management Docs](./docs/management.md) for info on using health checks, updating, backups, web-server configs, logs, performance, security, and more.

Deploying from Source ๐Ÿš€

You will need git, the latest or LTS version of Node.js and (optionally) Yarn installed on your system.

  • Get Code: git clone https://github.com/Lissy93/dashy.git and cd dashy
  • Configuration: Fill in your settings in ./public/conf.yml
  • Install dependencies: yarn
  • Build: yarn build
  • Run: yarn start

See docs [Full list of Dashy's commands](./docs/management.md#basic-commands)

Deploy to the Cloud โ˜๏ธ

Dashy supports 1-Click deployments on several popular cloud platforms. To spin up a new instance, just click a link below:

For more 1-click cloud deployments, see [Cloud Deployment](./docs/deployment.md#deploy-to-cloud-service)

โฌ†๏ธ Back to Top


Configuring ๐Ÿ”ง

For full configuration documentation, see: [Configuring](./docs/configuring.md)

Dashy is configured through a YAML file, located at ./public/conf.yml. In addition, you can find a complete list of available options in the Configuring Docs. The config can also be edited and saved directly through the UI.

โฌ†๏ธ Back to Top


Theming ๐ŸŽจ

For full theming documentation, see: [Theming](./docs/theming.md)

Dashy comes pre-bundled with several built-in themes, which you can preview, applied and edit through the UI. With the theme configurator and support for custom CSS, everything is in place to quickly develop your unique-looking dashboard.

โฌ†๏ธ Back to Top


Icons ๐Ÿงธ

For full iconography documentation, see: [Icons](./docs/icons.md)

Both sections and items can have an icon associated with them, defined under the icon attribute. With several different icon packs supported, you'll be able to find the perfect thumbnail for any app or service.

The following icon types are supported:

  • Favicon - Automatically fetch an apps icon from its Favicon or logo image
  • Icon Packs - Use any icon from font-awesome, simple-icons or material icons
  • Emoji - Any valid emoji can be used as an icon
  • Generative - Unique, auto-generated images for easily identifying services
  • URL - Pass the URL of any valid image in to have it fetched and rendered
  • Local - Store custom images locally and reference by filename
  • Homelab Icons - Using dashboard-icons for logos of commonly self-hosted services

โฌ†๏ธ Back to Top


Status Indicators ๐Ÿšฆ

For full monitoring documentation, see: [Status Indicators](./docs/status-indicators.md)

Dashy has an optional feature to check if each app/ service is up and responding, then display a small status indicator icon. Hovering over it will show additional stats like response time and status code.

Status indicators can be globally enabled by setting appConfig.statusCheck: true or enabled/ disabled on a per-item basis. Status is checked on page load, but you can allow continuous polling by specifying a time interval between checks, in seconds under appConfig.statusCheckInterval. You can also use a different endpoint for status checking, with statusCheckUrl, and if needed, pass in custom headers under statusCheckHeaders.

โฌ†๏ธ Back to Top


Widgets ๐Ÿ“Š

For full widget documentation, see: [Widgets](./docs/widgets.md)

You can display dynamic content from services in the form of widgets. There are several pre-built widgets availible for showing useful info, and integrations with commonly self-hosted services, but you can also easily create your own for almost any app.

โฌ†๏ธ Back to Top


Authentication ๐Ÿ’‚

For full authentication documentation, see: [Authentication](./docs/authentication.md)

Dashy has full support for secure single-sign-on using Keycloak for secure, easy authentication, see setup docs for a full usage guide.

There is also a basic auth feature, which doesn't require additional setup. To enable this, add an auth attribute under appConfig, containing an array of users, each with a username, SHA-256 hashed password and optional user type. Basic auth also supports several access control features, including read-only guest access and granular controls.

appConfig:
  auth:
    users:
    - user: alicia
      hash: 4D1E58C90B3B94BCAD9848ECCACD6D2A8C9FBC5CA913304BBA5CDEAB36FEEFA3
      type: admin

Other access control systems are also supported, see the [Alternative Auth Methods](./docs/authentication.md#alternative-authentication-methods) docs.

โฌ†๏ธ Back to Top


Alternate Views ๐Ÿ‘“

As well as the default homepage, there is also:

  • A minimal view, valid for use as a browser start page
  • A workspace view, useful for visiting many apps simultaneously

You can change the view from the UI, using the switch icon in the top-right corner, or select a default view in the config under appConfig.startingView attribute.

Example of Workspace View

Example of Minimal View

โฌ†๏ธ Back to Top


Opening Methods ๐Ÿ–ฑ๏ธ

For full documentation on views and opening methods, see: [Alternate Views](./docs/alternate-views.md)

There are several different ways you can launch apps. You can specify the default opening method for any given item under the target attribute or set a site-wide default under appConfig.defaultOpeningMethod. Right-click on an item to item for all options. The following options are supported:

  • sametab - The app will be launched in the current tab
  • newtab - The app will be launched in a new tab (or use Ctrl + Click)
  • modal - Launch app in a resizable/ movable popup modal on the current page (or use Alt + Click)
  • workspace - Changes to Workspace view and launches app
  • clipboard - Copy the app's URL to your system clipboard
  • top - Opens in the top-most browsing context, useful if you're accessing Dashy through an iframe

Searching and Shortcuts ๐Ÿ”Ž

For full documentation on searching, see: [Searching & Shortcuts](./docs/searching.md)

Quickly finding and launching applications is the primary aim of Dashy. To that end, instant search and customizable keyboard shortcuts are built-in.

To start filtering, start typingโ€”no need to select the search bar or use any special key. Then use either the tab key or arrow keys to select and move between results, and hit enter to launch the currently selected application.

For apps that you use regularly, you can set a custom keybinding. Use the hotkey parameter on a certain item to specify a numeric key between 0 - 9. You can then launch that app by just pressing that key.

You can also add custom tags to a given item to make finding them based on keywords easier. For example, in the following example, searching for 'Movies' will show 'Plex'

  items:
  - title: Plex
    hotkey: 8
    icon: favicon
    description: Media library
    url: https://plex.lab.local
    tags: [ movies, videos, music ]

To search the web directly through Dashy, just press enter after typing your query. Options for web search are set under appConfig.webSearch. There is built-in support for [10+ search engines](./docs/searching.md#setting-search-engine), or [use your own custom provider](./docs/searching.md#using-custom-search-engine) or self-hosted instance. With the web search, you can also define your bangs to redirect results to any given app, website, or search engine, when the query is preceded with a certain character sequence (usually beginning in /, ! or :).

webSearch:
  searchEngine: duckduckgo
  openingMethod: newtab
  searchBangs:
    /r: reddit
    /w: wikipedia
    /s: https://whoogle.local/search?q=
    ':wolf': wolframalpha
    ':so': stackoverflow
    ':git': github

Hit Esc at any time to close any open apps, clear the search field, or hide any modals.

โฌ†๏ธ Back to Top


Config Editor โš™๏ธ

For full config documentation, see: [Configuring](./docs/configuring.md)

As well as passing in a YAML config file, you can also configure the app directly through the UI and preview changes live.

To edit any section or item, right-click on it, and select "Edit", or enter the Edit Mode (using the Pen icon in the top-right), then click any part of the page to edit. Changes will be visible immediately but will not be saved until clicking "Save to Disk" or "Save Locally".

Under the config menu, you can export, view, backup, or reset app config and edit the raw config file in a text editor with built-in schema validation. It's recommended to keep a backup of your config.

โฌ†๏ธ Back to Top


Cloud Backup & Sync โ˜

For full backup documentation, see: [Cloud Backup & Sync](./docs/backup-restore.md)

Dashy has an optional built-in feature for securely backing up your config to a hosted cloud service and then restoring it on another instance. This is useful not only for backing up your configuration off-site but also enables Dashy to be used without having to write a YAML config file.

All data is fully E2E encrypted before being sent to the backend (done in CloudBackup.js using crypto.js 's AES method). The data is then sent to a Cloudflare worker and stored in a KV data store.

โฌ†๏ธ Back to Top


Language Switching ๐ŸŒŽ

For full internationalization documentation, see: [Multi-Language Support](./docs/multi-language-support.md)

Dashy supports multiple languages and locales. When available, your language should be automatically detected and applied on load. But you can also select a language through the UI (under config --> Switch Language) or set appConfig.language to your language (specified as a 2-digit ISO 639-1 code).

Supported Languages

  • ๐Ÿ‡ฌ๐Ÿ‡ง English: en - Default
  • ๐Ÿ‡จ๐Ÿ‡ณ Chinese: cn - Contributed by @FormatToday
  • ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch: nl - Contributed by @evroon
  • ๐Ÿ‡ฒ๐Ÿ‡ซ French: fr - Contributed by @EVOTk
  • ๐Ÿ‡ฉ๐Ÿ‡ช German: de - Contributed by @Niklashere
  • ๐Ÿ‡ณ๐Ÿ‡ด Norwegian Bokmรฅl: nb - Contributed by @rubjo
  • ๐Ÿ‡ต๐Ÿ‡ฑ Polish: pl - Contributed by @skaarj1989
  • ๐Ÿ‡ช๐Ÿ‡ธ Spanish: es - Contributed by @lu4t
  • ๐Ÿ‡ธ๐Ÿ‡ฎ Slovenian: sl - Contributed by @UrekD
  • ๐Ÿ‡ธ๐Ÿ‡ช Swedish: sv - Contributed by @BOZG
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian: it - Contributed by @alexdelprete
  • ๐Ÿ‡ต๐Ÿ‡น Portuguese: pt - Machine Translated (awaiting human review)
  • ๐Ÿ‡ท๐Ÿ‡บ Russian: ru - Contributed by Anon
  • ๐Ÿ‡ฆ๐Ÿ‡ช Arabic: ar - Contributed by Anon
  • ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi: hi - Contributed by Anon
  • ๐Ÿ‡ฏ๐Ÿ‡ต Japanese: ja - Contributed by Anon

Add your Language

I would love Dashy to be available to everyone without language being a barrier to entry. If you've got a few minutes to spare, consider adding translations for your language. It's a quick task, and all text is in a single JSON file. Since any missing text will fall back to English, you don't need to translate it all.

โฌ†๏ธ Back to Top


System Requirements ๐Ÿ“Š

If running on bare metal, Dashy requires Node V 16.0.0 or later, LTS (16.13.2) is recommended.

If running in Docker container, the recommended base image is Alpine (3.15)

The hardware requirements vary depending on where and how you are running Dashy. Generally speaking, on a bare-metal system or Docker container, 1GB of memory should be more than enough, and depending on whether you are using your own assets, then 1GB of disk space should be sufficient.

If you are using one of the 1-click cloud deployment methods, serving the app through a CDN or using a static hosting provider, then there are no specific requirements, as the built app is just a series of static JS files, and so is very light-weight.

Dashy also wells run on low-powered ARM-based single board computers, such as a Raspberry Pi (tested on Pi 3)

Browser Support Chrome | Firefox | IE | Opera | Safari --- | --- | --- | --- | --- | Latest โœ” | Latest โœ” | 10+ โœ” | Latest โœ” | 6.1+ โŒ |


Support ๐Ÿ™‹โ€โ™€๏ธ

If you're having trouble getting Dashy up and running, or have a question about usage or configuration, feel free to ask. The best place to do this is via the Discussions.

If you've found something which isn't working as it should, please raise a bug by opening a ticket.

It's best to check the [docs](./docs), previous issues and [troubleshooting guide](./docs/troubleshooting.md) first.

โฌ†๏ธ Back to Top


Supporting Dashy ๐Ÿ’–

For full details and other ways you can help out, see: [Contributing](./docs/contributing.md)

If you're using Dashy and would like to help support its development, then that would be awesome! Contributions of any type, any size, are always very much appreciated, and we will appropriately credit you for your effort.

Several areas that we need a bit of help with at the moment are:

  • Translating - Help make Dashy available to non-native English speakers by [adding your language](./docs/multi-language-support.md#adding-a-new-language)
  • Donate a small amount by Sponsoring @Lissy93 on GitHub and receive some extra perks!
  • Complete a short survey to have your say about future features
  • Share your dashboard in the Showcase, to inspire others
  • Spread the word by sharing Dashy or a screenshot of your dashboard to help new users discover it
  • Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget or something else
  • Star Dashy on GitHub/ DockerHub or leave an upvote / review on these platforms

[Sponsor Lissy93 on GitHub](./docs/assets/sponsor-button.svg)

โฌ†๏ธ Back to Top

Credits ๐Ÿ†

For a complete list of credits, and attributions to packages used within Dashy, see: [Credits](./docs/credits.md)

Thank you so much to everyone who has helped with Dashy so far; every contribution is very much appreciated.

Sponsors

Huge thanks to the sponsors helping to support Dashy's development! <!-- readme: sponsors -start --> Peng1can Stephen Rigney Robert Ernst Vlad Timofeev Byolock Hugalafutro Kieren Connell Gdepountis Ratty222 Undefined Jtfinley72 <!-- readme: sponsors -end -->

Contributors

[Auto-generated contributors](./docs/credits.md)

โฌ†๏ธ Back to Top


Developing ๐Ÿงฑ

For full development documentation, see: [Developing](./docs/developing.md)

Open Project in VS Code Open in GitPod Open in GitHub Code Spaces

Before getting started, you'll need Git, Node and optionally Yarn (run npm i -g yarn) installed.

To set up the development environment:

  1. Get Code: git clone https://github.com/Lissy93/dashy.git and cd dashy
  2. Install dependencies: yarn
  3. Start dev server: yarn dev
  4. Open the browser: http://localhost:8080

When you're ready, you can build the production app with yarn build, and then run it with yarn start

If you're new to web development, I've put together a short list of resources to help beginners get started

Repo Status: Open PRs Total PRs GitHub commit activity Last Commit Contributors

โฌ†๏ธ Back to Top


Documentation ๐Ÿ“˜

For full docs, see: [Documentation Contents](./docs/readme.md)

Running Dashy

  • ๐Ÿ’จ Quick Start - TDLR guide on getting Dashy up and running in under 5 minutes
  • ๐Ÿš€ Deployment - Full guide on setting up Dashy on various different environments
  • ๐Ÿ”ง Configuring - Complete list of all available options in the config file
  • ๐Ÿ’ป Management - Managing your app, updating, security, web server configuration, etc
  • ๐Ÿš’ Troubleshooting - Common errors and problems, and how to fix them

Feature Docs

  • ๐Ÿ›ก๏ธ Authentication - Guide to setting up authentication to protect your dashboard
  • ๐ŸŒˆ Alternate Views - Outline of available pages / views and item opening methods
  • ๐Ÿ’พ Backup & Restore - Guide to backing up config with Dashy's cloud sync feature
  • ๐Ÿงธ Icons - Outline of all available icon types for sections and items, with examples
  • ๐ŸŒ Multi-Language Support - Switching languages, and adding a new locales
  • ๐Ÿšฆ Status Indicators - Using Dashy to monitor uptime and status of your apps
  • ๐Ÿ” Searching & Shortcuts - Searching, launching methods + keyboard shortcuts
  • ๐ŸŽจ Theming - Complete guide to applying, writing and modifying themes + styles
  • ๐Ÿ“Š Widgets - List of all dynamic content widgets, with usage guides and examples

Development and Contributing

  • ๐Ÿงฑ Developing - Running Dashy development server locally, and general workflow
  • ๐Ÿ›Ž๏ธ Development Guides - Common development tasks, to help new contributors
  • ๐Ÿ’– Contributing - How to contribute to Dashy
  • ๐ŸŒŸ Showcase - See how others are using Dashy, and share your dashboard
  • ๐Ÿ† Credits - Shout out to the amazing people who have contributed so far
  • ๐Ÿ—ž๏ธ Release Workflow - Info about releases, CI and automated tasks

Misc

  • ๐Ÿ” Privacy & Security - List of requests, potential issues, and security resources
  • ๐Ÿ“„ License - Copy of the MIT License
  • โš–๏ธ [Legal](/.github/LEGAL.md) - Licenses of direct dependencies
  • ๐Ÿ“ [Code of Conduct](/.github/CODE_OF_CONDUCT.md) - Contributor Covenant Code of Conduct
  • ๐ŸŒณ [Changelog](/.github/CHANGELOG.md) - Details of recent changes, and historical versions

โฌ†๏ธ Back to Top


Roadmap ๐Ÿ›ฃ๏ธ

For upcoming features that will be released in the near future, see the Current Roadmap

For past updates, see the [Changelog](/.github/CHANGELOG.md)

โฌ†๏ธ Back to Top


Alternatives ๐Ÿ™Œ

A few self-hosted web apps serve a similar purpose to Dashy. If you're looking for a dashboard, and Dashy doesn't meet your needs, I highly recommend you check these projects out!

โฌ†๏ธ Back to Top


License ๐Ÿ“œ

Dashy is Licensed under MIT X11

Copyright ยฉ 2021 Alicia Sykes <https://aliciasykes.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or
substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE
OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, Dashy shall not be used in advertising or otherwise
to promote the sale, use, or other dealings in this Software without prior written
authorization from the repo owner.

TDLR; You can do whatever you like with Dashy: use it in private or commercial settings, redistribute and modify it. But you must display this license and credit the author. There is no warranty that this app will work as expected, and the author cannot be held liable for anything that goes wrong. For more info, see TLDR Legal's Explanation of MIT

FOSSA Status

โฌ†๏ธ Back to Top


Thank you for Visiting


*Note that all licence references and agreements mentioned in the Dashy README section above are relevant to that project's source code only.