Homarr App:-Dashboard for your Server

App
, ,
1

Homarr- A simple, yet powerful dashboard for your server. is now Available on Nethserver 8 as an App

compgeniuses/ns8-homarr: Nethserver 8 App for Homar https://homarr.dev/ (github.com)
Soon Enough Nethserver will have a tone of Apps, Many of which you re already using in your Home labs and Businesses, Sometime keeping tack of the Actual Links becomes a headache.

A Web Dashboard to the Rescue here:

image
image1901×929 128 KB

Features

  • :paintbrush: Highly customizable with an extensive drag and drop grid system
  • :sparkles: Integrates seamlessly with your favorite self-hosted applications
  • :pushpin: Easy and fast app management - no YAML involved
  • :speak_no_evil: Advanced secrets’ management system for enhanced security
  • :page_facing_up: Detailed documentation and active community
  • :mag: Search through the web or supported integrations in an instant
  • :black_flag:󠁧󠁢󠁮󠁩󠁲󠁿 Monitor your application with a built-in status system
  • :lobster: Comprehensive built-in icon picker with over 7000 icons
  • :whale: Easy deployment with Docker, unRAID, and Synology
  • :rocket: Compatible with any major consumer hardware (x86, Raspberry Pi, old laptops, …)
  • :dollar: Free and Open-Source - your data stays on your device. No telemetry data.
    homarr-self-hosted-dashboard-app-widget-category-nethserver-genius

You can download configuration files in the settings menu, and store them in homarr data directory, Then chose which config you want to load in the settings menu
homarr-self-hosted-dashboard-config-change

Installing
add-module ghcr.io/compgeniuses/homarr:latest 1

Access the App from the top right App menu
image

Configure your Settings

image
image991×491 11.7 KB

You SHould be able to access the App from the Web address

Configure your Administrative Details

image
image1873×904 89.6 KB

image
image804×433 15 KB

Define your first Link

image
image780×687 21.8 KB

Both internal and external Links, for internal

you need to check at http routes
image

You Should Finally have your Dashboard Setup

image
image1902×795 89.9 KB

Explore, Repot anything.

Notes
The tool is supposed to Have Automatic Docker Integration, Since we are USing Podman, the docker Sock has been been disabled.
Authentication(SSO)
:person_raising_hand: Single Sign On | Homarr documentation
The Tool Does Support OIDC as well as Ldap

AUTH_PROVIDER="ldap"
AUTH_LDAP_URI="ldap://example.com:3890"
AUTH_LDAP_BASE="dc=example,dc=com" // Same as LLDAP_LDAP_BASE_DN
AUTH_LDAP_BIND_DN="uid=admin,ou=People,dc=example,dc=com"
AUTH_LDAP_BIND_PASSWORD="adminpass" // Same as LLDAP_LDAP_USER_PASS

onfiguration​

Environment Variable Description Default value
AUTH_LDAP_URI URI of your LDAP server —
AUTH_LDAP_BASE Base dn of your LDAP server —
AUTH_LDAP_BIND_DN User used for finding users and groups —
AUTH_LDAP_BIND_PASSWORD Password for bind user —
AUTH_LDAP_USERNAME_ATTRIBUTE Attribute used for username uid
AUTH_LDAP_GROUP_CLASS Class used for querying groups groupOfUniqueNames
AUTH_LDAP_GROUP_MEMBER_ATTRIBUTE Attribute used for querying group member member
AUTH_LDAP_GROUP_MEMBER_USER_ATTRIBUTE User attribute used for comparing with group member dn
AUTH_LDAP_ADMIN_GROUP Admin group admin
AUTH_LDAP_OWNER_GROUP Owner group admin

IF Someone could help me with the Variables for Nethserver Ldap, We can pre-apply them for the given App.

Ill work also on figuring out the Ldap Authentication for Nethserver 8, so that its tightly integrated for user management
Let me know if its required, and how it would work with current Nethserver Setup

1 Like
2

Hi @oneitonitram,

your efforts are really commendable. However, I wonder if and to what extent this external software affects the security of NS 8 and if you end up opening security holes in the system yourself.

Regards

Uwe

3

Hello, thank you for your inputs.
this is only a link management Dashboard, it has not difference to as much as using bookmarks on your browser

This is a widely used tool, with almost 5k stars on github, if there is a security issue, it would be easy to take note of.

BEfore embarking on any tools, I first Do my reasearch, take a look at the Issues page Issues · ajnart/homarr (github.com)

as well as the Pull requests pages of the said tools Pull requests · ajnart/homarr (github.com)

Now, this specific Dashboard tool, actually has a CVE tracking Widget, if you check the first posted image, so it actually helps you keep track of security issues.

Homarr, has Authentication for accessing the dashboards, and therefore is actually more safer than using your browser bookmark.

by my understanding, All or most Apps by default are running rootless within Nethserver 8.

In consideration of what many tools on a server might mean, i have been looking into an in integration of a Security Monitoring and tracking Aggregation tool here

compgeniuses/ns8-copilot: this is an ns8 App for copilot https://github.com/socfortress/CoPilot from SOCFORTRESS

IT integrates into one dashboard, the following security monitoring tools

integrations with the following tools:

Contrary to what you might think, Most APPS i implement, I have done a big deal of research into them, asked questions in discord, watched reviews and many considerations before embarking on working on them

Equally, Some of the tools, as tools i have used before, and that people are installing and using in their home labs, and business use cases.

I am only providing an easy access method for deploying them, It does not prevent anyone in any way from installing them on their servers. Infact, by making them into an App, there are limitations pre-applied by Nethserver than allowing arbitrary installs.

Most are tools requested in some capacity within the forum before by community members and hey, i am not running all these tools, especially not on all on the same server, or even same server cluster.

@transocean what security observations and researvations might you have or have observed?

there is a dscussion here on disbaling public access for some apps

NS8 on VPS - restrict access to webservices - Support - NethServer Community

Am following app on the same with @stephdl to see how the same could be implemented for some apps, but generally its a feature i think would be worked on in near future on the core

2 Likes
4

new version coming up soon, Proxmox lovers, you’ll love this one

Release v0.15.3 · ajnart/homarr (github.com)

1 Like
5

@oneitonitram , sorry for hooking into the topic with another topic that struck me, but may I suggest ‘we’ take a look at a consistent naming convention:

  • App
  • Module
  • Application
  • Add-on

Since the early days ‘we’ have been using the word ‘module’. Any thoughts anybody? I mean consistency is a reliable and recognisable constant in a web of things.

No harm intended!

6

@LayLow this matter was discussed here Should we rename module to application or app? - Community - NethServer Community

1 Like