Skip to main content

Integrations

Homarr will integrate with a ton of different apps on your system.

caution

Homarr usually does not suport beta, alpha or older legacy versions of integrations, because new versions often contain breaking API changes. We will not support these, because the underyling API often changes frequently and would require much attention for very little outcome.

Torrent Clients​

Homarr supports a total of 3 Torrent clients. You can use them to display your torrents directly on your dashboard and see if you are leeching / seeding.

Deluge​

The Deluge integration is used by the following widgets:

Available configuration options
FieldTypeDescription
PasswordPrivateUsed for authenticating with the Deluge service

Transmission​

The Transmission integration is used by the following widgets:

Available configuration options
FieldTypeDescription
UsernamePrivateUsername used for authentication
PasswordPrivatePassword used for authentication

qBittorrent Integration​

The qBittorrent integration is used by the following widgets:

Available configuration options
FieldTypeDescription
UsernamePrivateUsername used for authentication
PasswordPrivatePassword used for authentication

Please note the known issue with qBittorrent: qBittorrent webUI showing Unauthorized


Usenet Clients​

SABnzbd​

The SABnzbd integration directly communicates with your download client and enables you to view and control your downloads directly from Homarr. You can use this integration from the Usenet Widget.

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

NZBGet​

The NZBGet integration directly communicates with your download client and enables you to view and control your downloads directly from Homarr. You can use this integration from the Usenet Widget.

Available configuration options
FieldTypeDescription
UsernamePrivateUsername used for authentication
PasswordPrivatePassword used for authentication

Collection Managers​

Sonarr​

Homarr will integrate the shows of your Sonarr calendars in the Calendar Widget

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

Radarr​

Homarr will integrate the shows of your Radarr calendars in the Calendar Widget

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

Lidarr​

Homarr will integrate the shows of your Lidarr calendars in the Calendar Widget

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

Readarr​

Homarr will integrate the shows of your Readarr calendars in the Calendar Widget

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

Dash.​

The Dash. integration can be used to monitor the performance and used system resources of your machine. Dash. will be used in the Dash.


Overseerr & Jellyseerr​

The Overseerr integration will enable you to request movies and series directly from your Homarr dashboard.

After choosing the correct type, you can search for content:

It displays, which content is already in your Overseerr library and links availble content directly to your Plex or Jellyfin instance.

Available configuration options
FieldTypeDescription
ApiTokenPrivateToken used for authentication

Initial setup​

Installation of Media Server​

The Overseer integration supports both Overseer and Jellyseer, a fork of Overseer compatible with Jellyfin.

Install Plex on your machine using your preferred installation method: https://www.plex.tv/
We recommend the installation using Docker for the easiest and fastest installation.

Installation of Media requester​

After you have your Plex instance up and running, you must install Overseer as your media request application. Please read the official documentation of how to install Overseerr on your machine: https://docs.overseerr.dev/getting-started/installation.

Add your application in Homarr​

If your instance of Overseerr or Jellyseerr is up and running, it's time to add it to your dashboard. Simply select the correct type from the integration tab when editing the application:

Select Overseerr in the app type for your Overseerr app.
Fill our the field Api token with from the link below, when having Overseerr as the app type selected.

Searching for a movie / series​

To search for a movie or series, simply press CTRL + K or click into the search box. Then, type !os (with a space at the end) and enter, what you want to search for.

The integration will display, what content is already available in your media library.

Seasons selection​

If you're selecting a series, you'll be asked what seasons you want to request:

season selector


Docker​

Homarr allows you to interact with Docker containers running on your system.

You can restart, stop, start, refresh and remove containers as well as add them to the Homarr dashboard

Docker Core Features

Additonally, if you have a lot of containers you can search and filter them by container or image name

Contailer and Image Search

View the state of each container (created, running or stopped)

Container States

And also check what ports the container has exposed (container port:external port)

Exposed Ports

Before you begin​

In order for Homarr to be able to interact with your Docker instance you must tell Homarr the path to your Docker socket. You do this by adding the following to the Docker command when you first run Homarr:

-v /var/run/docker.sock:/var/run/docker.sock