Skip to content

Latest commit

 

History

History
141 lines (91 loc) · 3.79 KB

Extras:-Heimdall.md

File metadata and controls

141 lines (91 loc) · 3.79 KB

Heimdall is a dashboard for all your web applications and any other links you like to add. It can be set as your browser's start page, with the ability to include a search bar using either Google, Bing or DuckDuckGo.

alt text

1. Accessing Heimdall

To access Heimdall, visit https://heimdall.yourdomain.com

2. First Time Setup

1. Add Subdomain for Heimdall

See [[Adding a Subdomain | Extras: Adding a Subdomain]] on how to add the subdomain heimdall to your DNS provider.

2. Install Heimdall

Run the following commands:

cd ~/cloudbox/
sudo ansible-playbook cloudbox.yml --tags install-heimdall

3. Setup a Login

By default, Heimdall is installed without a password.

To set up a login, run the following command:

htpasswd -c /opt/nginx-proxy/htpasswd/heimdall.yourdomain.com USERNAME

Replacing USERNAME with your desired username. You will then be prompted for a password.

3. Customizing

You are not limited to just the applications on your server with Heimdall. You can use it for anything, including all your bookmarks and your favorite search engine.

1. Adding Items

  1. You can add items to Heimdall by clicking the items tab follow by the add button.

  2. Many of the applications that you may use have logos and hex colors filled in. You are able to change these if needed, however, not all of your applications will have these and you will have to do it manually.

  3. In the picture above, you will see a spot to login at the bottom. This is not used for every application as some will require just an API key. This allows you to have a quick glance at the service, pictured below.

2. Organizing

  1. Clicking this switch allows you reorganize your tabs. This is very helpful after adding a whole bunch, in no certain order.

  2. You now be able to drag and drop. You will also see a pin tab, which will disappear when you exit out.

  3. This allows you to add and remove items very fast, while saving them for later.

  4. If for any reason your tabs are not showing current information you can refresh with the refresh button.

4. Tags

Have a lot of stuff? Want to organize each service? The tags work much like a folder, where you can place items inside. You can even stack them on top of each other.

  1. Just add a tag like you would a normal application. Then you can assign applications to the tag when setting up or editing them.

  2. The tag is seen with a tag symbol on the right.

5. Settings

In the settings menu you can find the options to update, change the background, and even add a search engine to it.

4. Supported Applications

You can add your own applications to Heimdall, but below are the predefined ones. There are two different types. Foundation apps are your basic applications without any api access. Enhanced apps can have additional information to provide a quick glance at them.

Enhanced

  • Couchpotato
  • Tautulli
  • Pihole
  • Sabnzbd
  • NZBGet
  • RuneAudio

Foundation

  • Watcher
  • OpenMediaVault
  • Krusader
  • Airsonic
  • Glances
  • Dokuwiki
  • SickRage
  • Gitea
  • Ombi
  • TT-RSS
  • Graylog
  • NZBHydra
  • NZBHydra2
  • Medusa
  • Deluge
  • rTorrent/ruTorrent
  • OPNSense
  • Netdata
  • Lidarr
  • Sonarr
  • Radarr
  • pFsense
  • UniFI
  • Portainer
  • Plex
  • Emby
  • Duplicati
  • JDownloader
  • openHAB
  • McMyAdmin
  • Plexrequests
  • Traefik
  • Nextcloud