{"id":13404851,"url":"https://github.com/linuxserver/Heimdall","last_synced_at":"2025-03-14T09:31:49.022Z","repository":{"id":37276027,"uuid":"119047018","full_name":"linuxserver/Heimdall","owner":"linuxserver","description":"An Application dashboard and launcher","archived":false,"fork":false,"pushed_at":"2024-06-20T23:13:33.000Z","size":33242,"stargazers_count":7834,"open_issues_count":24,"forks_count":542,"subscribers_count":85,"default_branch":"2.x","last_synced_at":"2024-10-29T14:55:51.918Z","etag":null,"topics":["application-dashboard","bookmark","couchpotato","dashboard","emby","heimdall","homepage","htpc","landing","landingpage","muximux","nginx","nzbget","organizr","plex","radarr","sabnzbd","server","sonarr","startpage"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linuxserver.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"linuxserver","open_collective":"linuxserver"}},"created_at":"2018-01-26T12:04:05.000Z","updated_at":"2024-10-28T15:34:31.000Z","dependencies_parsed_at":"2023-12-18T17:30:11.002Z","dependency_job_id":"de2c44d9-7b1e-4d4a-b751-3cdeea017b03","html_url":"https://github.com/linuxserver/Heimdall","commit_stats":{"total_commits":903,"total_committers":89,"mean_commits":"10.146067415730338","dds":0.7353266888150609,"last_synced_commit":"f405cf2ddf237995aa0b2f98f5ece66206a21d9c"},"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2FHeimdall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2FHeimdall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2FHeimdall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver%2FHeimdall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linuxserver","download_url":"https://codeload.github.com/linuxserver/Heimdall/tar.gz/refs/heads/2.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242962717,"owners_count":20213510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application-dashboard","bookmark","couchpotato","dashboard","emby","heimdall","homepage","htpc","landing","landingpage","muximux","nginx","nzbget","organizr","plex","radarr","sabnzbd","server","sonarr","startpage"],"created_at":"2024-07-30T19:01:52.278Z","updated_at":"2025-03-14T09:31:49.005Z","avatar_url":"https://github.com/linuxserver.png","language":"PHP","readme":"# Heimdall\n\n[![Heimdall_Banner](https://i.imgur.com/iuV8w3y.png)](https://heimdall.site)\n\n[![Discord](https://img.shields.io/discord/354974912613449730.svg)](https://discord.gg/CCjHKn4)\n[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/heimdall.svg)](https://hub.docker.com/r/linuxserver/heimdall/)\n[![firsttimersonly](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://www.firsttimersonly.com/)\n[![Paypal](https://heimdall.site/img/paypaldonate.svg)](https://www.paypal.me/heimdall)\n\n___\n\nVisit the website - https://heimdall.site\n___\n\n## About\nAs the name suggests Heimdall Application Dashboard is a dashboard for all your web applications. It doesn't need to be limited to applications though, you can add links to anything you like.\n\nHeimdall is an elegant solution to organise all your web applications. It’s dedicated to this purpose so you won’t lose your links in a sea of bookmarks.\n\nWhy not use it as your browser start page? It even has the ability to include a search bar using either Google, Bing or DuckDuckGo.\n\n![Heimdall demo animation](https://i.imgur.com/MrC4QpN.gif)\n\n## Video\nIf you want to see a quick video of Heimdall in use, go to https://youtu.be/GXnnMAxPzMc\n\n## Supported applications\nYou can use the app to link to any site or application, but Foundation apps will auto fill in the icon for the app and supply a default color for the tile. In addition, Enhanced apps allow you provide details to an apps API, allowing you to view live stats directly on the dashboard. For example, the NZBGet and Sabnzbd Enhanced apps will display the queue size, and download speed while something is downloading.\n\nSupported applications are recognized by the title of the application as entered in the title field when adding an application. For example, to add a link to pfSense, begin by typing \"p\" in the title field and then select \"pfSense\" from the list of supported applications.\n\n[![enhancedapps](https://img.shields.io/badge/dynamic/json.svg?label=Enhanced%20Apps\u0026url=https%3A%2F%2Fapps.heimdall.site%2Fstats\u0026query=enhanced_apps\u0026colorB=3f8483\u0026style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAjCAMAAACw/5reAAAAnFBMVEUAAADu7u7u7u7u7u7u7u7x8fHu7u7u7u7u7u7u7u7u7u7u7u7r6+vu7u7v7+/u7u7t7e3v7+/v7+/u7u7u7u7u7u7u7u7u7u7u7u7u7u7v7+/u7u7p6ent7e3v7+/v7+/v7+/u7u7u7u7u7u7u7u7t7e3////u7u7u7u7u7u7u7u7w8PDw8PDt7e3u7u7t7e3s7Ozu7u7t7e3u7u4TnCP6AAAAM3RSTlMA+9n3phHw3czC088M5Y5zG6mflWdJFumyfj4sB2NeTi7hiWlDOQPGt5lsMiG9hFQntpFqxQJtAAABnElEQVQoz2WRh3KrQAxFtYWO6ZhucItrynv6/3/LFnA24c6wurpnYBkJZvXduNix6+GXTo8qWnxUPU4m2w0O1ktTozPsftiZpejGlm7C2MWUnRcWOohIo36+PaKyDZdLUOgDXvqQfaT9kwkfvP3AN18E7Kl8hkJHMHSXSSadxaTtTNjJhMkfjFHKMqGlolg4T7mtCbcq8gBCotxkwklFLIQSlQoTHnVWQqzNxYQuzpfmqGVMc5ijHK5yAuIhxbZ5p/S92RZkjv5BKs6aosSIr0JrcXBo1FtICVINKRKK6u0GnraoN84O5KbhjRwYzxCJnQCMtotkdNxjq2F7dJ2RoGuXIBTvc3ROthdmat6hZ7cOyfcxKGV+wTxBkxQxTQTzWOFny/7qS2nzx37T7nbtZj9xu7zUr/323nVy0sQnhwMJktSZrl5v7CjgSQmWi+haUCY8sH4tyc/FGSKGouS+WqBJm8U2NIE/+nLu2tzpF/xVNGy02QzRClafC/ysVpDzQJuA8xXsKl8bv+pgpXz57H9Yy3J1lQNY62wUrW+mdzrylWS0QwAAAABJRU5ErkJggg==)](https://apps.heimdall.site/applications/enhanced)\n\n[![foundationapps](https://img.shields.io/badge/dynamic/json.svg?label=Foundation%20Apps\u0026url=https%3A%2F%2Fapps.heimdall.site%2Fstats\u0026query=foundation_apps\u0026colorB=3f8483\u0026style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAjCAMAAACw/5reAAAAnFBMVEUAAADu7u7u7u7u7u7u7u7x8fHu7u7u7u7u7u7u7u7u7u7u7u7r6+vu7u7v7+/u7u7t7e3v7+/v7+/u7u7u7u7u7u7u7u7u7u7u7u7u7u7v7+/u7u7p6ent7e3v7+/v7+/v7+/u7u7u7u7u7u7u7u7t7e3////u7u7u7u7u7u7u7u7w8PDw8PDt7e3u7u7t7e3s7Ozu7u7t7e3u7u4TnCP6AAAAM3RSTlMA+9n3phHw3czC088M5Y5zG6mflWdJFumyfj4sB2NeTi7hiWlDOQPGt5lsMiG9hFQntpFqxQJtAAABnElEQVQoz2WRh3KrQAxFtYWO6ZhucItrynv6/3/LFnA24c6wurpnYBkJZvXduNix6+GXTo8qWnxUPU4m2w0O1ktTozPsftiZpejGlm7C2MWUnRcWOohIo36+PaKyDZdLUOgDXvqQfaT9kwkfvP3AN18E7Kl8hkJHMHSXSSadxaTtTNjJhMkfjFHKMqGlolg4T7mtCbcq8gBCotxkwklFLIQSlQoTHnVWQqzNxYQuzpfmqGVMc5ijHK5yAuIhxbZ5p/S92RZkjv5BKs6aosSIr0JrcXBo1FtICVINKRKK6u0GnraoN84O5KbhjRwYzxCJnQCMtotkdNxjq2F7dJ2RoGuXIBTvc3ROthdmat6hZ7cOyfcxKGV+wTxBkxQxTQTzWOFny/7qS2nzx37T7nbtZj9xu7zUr/323nVy0sQnhwMJktSZrl5v7CjgSQmWi+haUCY8sH4tyc/FGSKGouS+WqBJm8U2NIE/+nLu2tzpF/xVNGy02QzRClafC/ysVpDzQJuA8xXsKl8bv+pgpXz57H9Yy3J1lQNY62wUrW+mdzrylWS0QwAAAABJRU5ErkJggg==)](https://apps.heimdall.site/applications/foundation)\n\n## Installing\nApart from the Laravel 10 dependencies, namely PHP \u003e= 8.1, Ctype PHP Extension, cURL PHP Extension, DOM PHP Extension, Fileinfo PHP Extension, Filter PHP Extension, Hash PHP Extension, Mbstring PHP Extension, OpenSSL PHP Extension, PCRE PHP Extension, PDO PHP Extension, Session PHP Extension, Tokenizer PHP Extension, XML PHP Extension, the only other thing Heimdall needs is sqlite support and zip support (php-zip).\n\nIf you find you can't change the background make sure `php_fileinfo` is enabled in your php.ini. I believe `php_fileinfo` should be enabled by default, but one user came across the issue on a windows system.\n\nInstallation is as simple as cloning the repository somewhere, or downloading and extracting the zip/tar and pointing your httpd document root to the `/public` folder then creating the .env file and generating an encryption key (this is all taken care of for you with the docker). \n\n```\ncd /path/to/heimdall\ncp .env.example .env\nphp artisan key:generate\n```\n\nFor simple testing you could just go to the folder and type `php artisan serve`\n\nThere is also a multi-arch Docker which supports x86-64, armhf and arm64, instructions on how to use them at\n\n- https://hub.docker.com/r/linuxserver/heimdall/\n\n## Updating\nTo update your instance, simply clone this repository or download the zip/tar file with the new version and copy it over the old installation.\n\n## Search Providers\nv2.3.0 added the ability for users to customise the search options.\n\nOptions are stored in `/storage/app/searchproviders.yaml` (`/config/www/searchproviders.yaml` on docker installs), feel free to rearrange the options, add new ones, delete ones you don't use, etc.\n\nConsider contributing to https://github.com/linuxserver/Heimdall/discussions/categories/search-providers to help others add new ones.\n\nThe item at the top of the list `Tiles` allows you to search for apps on your dashboard by name, this can be helpful when you have lots of icons.\n\n## New background image not being set\nIf you are using the docker image or a default php install you may find images over 2MB won't get set as the background image, you just need to change the `upload_max_filesize` in the php.ini.\n\nIf you are using the linuxserver.io docker image simply edit `/path/to/config/php/php-local.ini` and add `upload_max_filesize = 30M` to the end.\n\n## Docker and enhanced apps\nIf you are running the docker and the EnhancedApps you are using are also in dockers, you may need to use the docker networking addresses to communicate with them.\n\nYou can do this by using `http(s)://docker_name:port` in the config section. Instead of the name you can use the internal docker ip, this usually starts with `172.`\n\n## Languages\nThe app has been translated into several languages; however, the quality of the translations could benefit from some work. If you would like to improve them, or help with other translations, they are stored in `/resources/lang/`.\n\nTo create a new language translation, make a new folder with the ISO 3166-1 alpha-2 code as the name, copy `app.php` from `/resources/lang/en/app.php` into your new folder and replace the English strings.\n\nWhen you are finished, create a pull request.\n\nCurrently added languages are\n\n- Breton\n- Chinese\n- Danish\n- Dutch\n- English\n- Finnish\n- French\n- German\n- Greek\n- Hungarian\n- Italian\n- Japanese\n- Korean\n- Lombard\n- Norwegian\n- Polish\n- Portuguese\n- Russian\n- Slovenian\n- Spanish\n- Swedish\n- Turkish\n\n## Web Server Configuration\n\n### Apache\nA `.htaccess` file ships with the app, however, a lot of apache installations disallow `.htaccess` files by default.\nYou will notice this due to some links not working like `/settings`.\nIn addition mod-rewrite needs to be enabled if it isn't already.\n\n#### Fixes \u0026 work around options\n##### - Apache global allow .htaccess\nFind the `AllowOverride None` line in your apache configuration and change this to `AllowOverride All`\n\n##### - Apache vhost configuration allow .htaccess\nIn the apache vhost configuration in the `\u003cDirectory /\u003e` block add `AllowOverride All`\n\n##### - Add .htaccess content in apache configuration\nYou can add the full `.htaccess` into your apache configuration, this way you do not need to allow `.htaccess` files.\nYou can even shorten the content of the `.htaccess` when inserting it into the apache configuration to:\n```\nOptions +FollowSymLinks\nRewriteEngine On\n\nRewriteCond %{REQUEST_FILENAME} !-d\nRewriteCond %{REQUEST_FILENAME} !-f\nRewriteRule ^ index.php [L]\n```\n#### More info\nMore info about `AllowOverride` can be found here:\nhttps://httpd.apache.org/docs/2.4/mod/core.html#allowoverride\n\n\n\n### Nginx\nIf you are using Nginx, the following directive in your site configuration will direct all requests to the `index.php` front controller:\n\n```\nlocation / {\n    try_files $uri $uri/ /index.php?$query_string;\n}\n```\nSomeone was using the same Nginx setup to both run this and reverse proxy Plex. Plex is served from `/web` so their location was interfering with the `/webfonts`.\n\nTherefore, if your fonts aren't showing because you have a location for `/web`, add the following:\n```\nlocation /webfonts {\n    try_files $uri $uri/;\n}\n```\nIf there are any other locations that might interfere with any of the folders in the `/public` folder, you might have to do the same for those as well, however it's a super fringe case.\n\n### Reverse proxy\nIf you'd like to reverse proxy this app, we recommend using our letsencrypt/nginx docker image: [SWAG - Secure Web Application Gateway](https://hub.docker.com/r/linuxserver/swag)\nYou can either reverse proxy from the root location, or from a subdomain (subfolder method is currently not supported). For HTTPS proxy, make sure you use the HTTPS port of Heimdall webserver, otherwise some links may break. You can add security through `.htpasswd`\n\n```\nlocation / {\n    auth_basic \"Restricted\";\n    auth_basic_user_file /config/nginx/.htpasswd;\n    include /config/nginx/proxy.conf;\n    proxy_set_header X-Forwarded-Proto https;\n    proxy_pass http://heimdall;\n}\n```\n\n### Self-signed certificates and local CAs\nPer default Heimdall uses the standard certificate bundle file (`ca-certificates.crt`) to verify HTTPS sites and will ignore additional certificates placed in `/etc/ssl/certs`. If you wish to use enhanced apps with HTTPS sites that use a self-signed certificate or certs signed with your own local CA, you can override the default bundle:\n\n- Create a unified certificate `.pem` file that contains all CAs and certificates that Heimdall has to verify. For example, if you use both LetsEncrypt and a local CA for your internal apps, concatenate the LetsEncrypt intermediate CA (export via browser) and your local CA `cert.pem` (or any number of self-signed certs) into one `heimdall.pem` file.\n- Place the `heimdall.pem` into the container (if you use Docker), for example by placing it in the path that you mapped to `/config`. Make sure that the Heimdall user has read access (`chmod a+r`).\n- Set the `openssl.cafile` setting in `/config/php/php-local.ini` to your cert bundle:\n\n```\n# /config/php/php-local.ini\nopenssl.cafile = /config/heimdall.pem\n```\n\nRestart the container and the Enhanced apps should now be able to access your local HTTP websites. This configuration will survive updating or recreating the Heimdall container.\n\n## Running offline\nThe apps list is hosted on github, you have a couple of options if you want to run without a connection to the outside world:\n1) Clone the repository and host it yourself, look at the .github actions file to see how to generate the apps list.\n2) Download the apps list and store it as a JSON accessible to Heimdall named `list.json`\n\nWith both options all you need to do is add the following to your `.env`\n`APP_SOURCE=http://localhost/` Where `http://localhost/` is the path to the apps list without the name of the file, so if your file is stored at `https://heimdall.local/list.json` you would put `APP_SOURCE=https://heimdall.local/`\n\n## Support\nhttps://discord.gg/CCjHKn4 or through GitHub issues\n\n## Donate\nIf you would like to show your appreciation, feel free to use the link below.\n\n[![PayPal](https://heimdall.site/img/paypaldonate.svg)](https://www.paypal.me/heimdall)\n\n## Credits\n- PHP Framework - [Laravel](https://laravel.com/)\n- Icons - [FontAwesome 5](https://fontawesome.com/)\n- JavaScript - [jQuery](https://jquery.com/)\n- Colour picker - [Huebee](http://huebee.buzz/)\n- Background image - [pexels](https://www.pexels.com)\n- Trianglify library - [Trianglify](https://github.com/qrohlf/trianglify)\n- Everyone at Linuxserver.io that has helped with the app and let's not forget IronicBadger for the following question that started it all:\n```\nYou know, I would love something like this landing page for all my servers' apps\nthat gives me the ability to pin favourites\nand / or search\n@Stark @Kode do either of you think you'd be able to rustle something like this up?\n```\n\n## License\n\nThis app is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n","funding_links":["https://github.com/sponsors/linuxserver","https://opencollective.com/linuxserver","https://www.paypal.me/heimdall"],"categories":["PHP","Apps","server","By Language","Projects","Dashboards and Homepages","Alternatives 🙌","Table of Contents","Other","Dashboards"],"sub_categories":["Dashboard","PHP","Hosted","IRC Search Engines","Deploy to the Cloud ☁️","Observability"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver%2FHeimdall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinuxserver%2FHeimdall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver%2FHeimdall/lists"}