Feature : Move integrations in a separate tab in management page

[ajnart]

Description

The idea

Integrations should be dashboard-wide, they should be managed by the admins and offer an easy to operate UI to be added, modifed and tested.

Realization

• Remove integrations from the app creation process
• Adjust the documentation accordingly
• Add an integrations panel in manage page
• • Add a way to add an integration
• • Display all the current integrations
• • • Get the integrations passwords, api keys, ... from the config (not write only anymore)
• • Add a way to test an integration, this should do a "test" api call and return the version of the integration (or just OK/KO)
• • Add a way to check all integrations health at the bottom of that page
• • Add a links to the docs about that specified integration. (this link could also be opened as an iframe inside of the app)

Each integration should have :

• Name
• IP / Internal address
• Fields depending on the requirements of said integration (password / api keys, ...)

Priority:

High / Highest

Release milestone

v0.15.0

Related issues

#1119

Priority

Medium (Would be very useful)

[Meierschlumpf]

@ajnart question about this feature:

• Are integrations active for every board automatically?
• Are integrations bound to widgets?
• How does it work with the search with Jellyseer and Overseer?

[ajnart]

@ajnart question about this feature:

• Are integrations active for every board automatically?

• Are integrations bound to widgets?

• How does it work with the search with Jellyseer and Overseer?

1 - Yes integrations are shared with all boards, only the admin can access the integrations panel, it is both accessible inside of the boards page via a modal as well as the /manage page via a full on page (with ssr preloading)

2 - Ideally we would return the list of integrations available during SSR inside of the boards by returning only their ID, Name, Type and possibly description/internal url and then be able to have some kind of selector for each widget on its settings (like a multi-select list) That probably means a lot of re-writing the error states of widgets but it would be a lot easier to detect
If we are talking in the context of the DB update it would be easy to make a relation to the service, maybe ?
-- but that's ideally, I didn't really think about that, I would've just used everything in the first place.

3 - I am not sure. I don't know why someone would have Jellyseer and Overseer or multiple instances of each. If it's really something to consider we might add it as a single select inside of the boards customizations where the new toggle to hide the search bar is

Do you think my answers are clear ?

[Meierschlumpf]

Seems good, thanks

[github-actions]

Hello 👋, this issue has been open for 60 without activity. Please close this issue if it's no longer relevant or has been resolved. Still relevant? Simply reply and I'll mark it as active.

[Meierschlumpf]

Closed by homarr-labs/homarr#11
This feature will be part of v1.0, see #1993