Build a Homelab Dashboard: Part 3, Organizr Continued

I know, I know…I promised InfluxDB would be my next post.  But, I’ve noticed that Organizr is not quite as straight forward to everyone as I thought.  So today we’ll be configuring Organizr and InfluxDB will wait until our next post.  Before we continue with configuring Organizr, let’s recap our series so far:

  1. An Introduction
  2. Organizr
  3. Organizr Continued
  4. InfluxDB
  5. Telegraf Introduction
  6. Grafana Introduction
  7. pfSense
  8. FreeNAS

Configuring Organizr

Organizr is not always the most straight forward tool to configure.  Integration with things like Plex requires a bit of knowledge.  It doesn’t help of course that V2 is still in beta and the documentation doesn’t actually exist yet.  Let’s get started where we left off.  Let’s log in:

Adding a Homepage

Once logged in, we’re ready to start by adding the homepage to our tabs.  Click on Tab Editor:

Click on Tabs and you will notice that the homepage tab doesn’t appear on our tabs, so let’s move it around and make it active.  While we’re at it we’ll also make it the default.  We’ll get into why a little bit later.

Add a Tab

Now we can move on to adding the Plex tab.  Click the + sign:

Give the tab a name, in this case we’ll go with Plex.  Provide the URL to your Plex instance.  Choose an image, and click Add Tab:

Move the Plex tab up, make it active, and select the type of iFrame:

The different types are iFrame, Internal, or New Window.  Two of these are self-explanatory.  iFrame provides the URL directly inside of Organizr.  New Window opens a new tab in your browser.  The third, internal is for things like the homepage and settings that are built-in functionality in Organizr.  Many services works just fine in an iFrame, but some may experience issues.  For instance, pfSense doesn’t like being in an iFrame while FreeNAS doesn’t mind at all.  There are plenty of other options around groups and categories, but for now we’ll keep things simple.

The Homepage

Now that we know how to add tabs, how do we make our homepage look like this:

Getting Plex Tokens

What we see here is one of the main reasons you should consider Organizr.  This includes integration with Plex, Sonarr, and Radarr.  Let’s start with Plex.  Plex has an API that allows external applications like Organizr to integrate.  Configuring Plex isn’t all that straight forward unfortunately.  We’ll start by going back to our settings page and clicking on System Settings, then Single Sign-On, and finally Plex.

We are not trying to enable SSO right now, though you would likely be able to at the end of this guide with a single click.  We are just going to use this page as a facility to give us the Plex API Token and the Plex Machine Name.  These are required to enable homepage integration.  Click on Retrieve under Get Plex Token:

Enter your username and password for Plex and click Grab It:

Assuming you remember your username and password correctly, you should get a message saying that it was created and you can now click the x to go see it:

Now we can click on the little eye to see the Plex token.  Copy and paste this somewhere as we will need it later.

Next, we’ll click the retrieve button under Get Plex Machine:

Choose your Plex Machine that you want to integrate into Organizr:

The interesting part here is that it doesn’t actually say it did anything after you make the selection.  So just click the x and then we are ready to click the little eye again.  This time we will copy and paste the Plex Machine Name:

Plex Homepage Integration

Now that we have our Plex tokens, we can configure the homepage integration with Organizr.  Click on System Settings, then Tab Editor, followed by Homepage Items, and finally Plex:

Start by enabling Plex integration and then click on Connection:

Now enter our Plex URL and then refer back to your Plex tokens that you copied and pasted somewhere.  Click on Active Streams:

Enable active streams and click on Recent Items:

Enable recent items and click on Test Connection:

Be sure to click Save before finally clicking Test Connection:

Assuming everything went well, we should see a message in the bottom right corner that states:

Now let’s go take a look at what we get when we reload Organizr:

Calendar Integration

Another really cool aspect of Organizr is the consolidated calendar.  What does it consolidate?  Things like Radarr, Sonarr, and Lidarr.  It works much like the calendar on an iPhone or Android device in this way.  Today we’ll configure Organizr with Radarr and Sonarr.


We’ll start by going to our Sonarr site and clicking on Settings and then the General tab:

Once on the general tab, you should see your API key:

As with out Plex token, we’ll copy the API key and paste it somewhere while we go back into Organizr.  Back in Organizr, go to settings and click on Tab Editor, then Homepage Items, and finally Sonarr:


Click enable and then on the Connection tab:

Now enter your Sonarr URL, click Save, and click Test Connection:

Click Test Connection:

Assuming everything went well, we should see a message in the bottom right corner that states:

Now we can reload Organizr and check out our homepage:

Excellent!  We have a calendar that is linked to Sonarr.


Radarr and Sonarr configure exactly the same, so I won’t bore you with the same screenshots with a different logo.


The last Homepage item we will configure is SABnzbd.  Before we configure Organizr, we’ll go get our API key just like Plex, Sonarr, and Radarr.  Click on configuration:

Click on the General tab:

Now we can copy our API Key and paste it somewhere for later:

Back in Organizr, go to settings, click Tab Editor, Homepage Items, and finally SABNZBD:

Click enable and then click Connection:

Enter your SABnzbd URL, your API key, click Save, and then Test Connection:

Now click Test Connection:

Assuming everything went well, we should see a message in the bottom right corner that states:

Now let’s reload Organizr and take a look at our homepage:

Excellent!  Now we can move on to reordering everything the way we want it on the homepage.


Go to settings and click on Tab Editor, then Homepage Order.  I prefer to have Plex above SABnzbd, so I drag SABnzbd just after Plex:

Be sure to click Save and it should look something like this:

Finally we can reload Organizr one last time and check it out:


And that’s that.  We have a barebones Organizr configuration completed and we are ready to move on to InfluxDB (for real this time)!  Happy dashboarding!


  • Bard

    API Connection failed (reset by peer) on Plex, Sonarr and Radarr load the calendar but the tabs don’t load anything. Deluge just return a white page. I guess I know what to try and fix while I wait for the next post 😀

  • Austin Kohler

    You mentioned you use this with pfsense, I can’t get mine to work. Was there any extra you needed to do?

    • Brian Marshall

      I use it as an external link. It won’t work out of the box in an iFrame without modification…which I haven’t figured out yet…

  • August


    I could NOT find anything anywhere on how to get the homepage to work properly except to be told that, “you just name it ‘homepage.php’” which of course did nothing and so for two days I messed around with the setting trying different things before stumbling across this article! I figured out several of the other things you mention but the homepage thing was a serious pita and quite the oversight if you ask me!

    Thank you so much!

    Now if I can just bash my head for a few more weeks while trying to figure out how to get nginx and php to get everything connected to my URL for a reverse proxy!

  • Darren

    Of course I have to go into Settings | Single Sign-on | Plex and then click “Get Plex Machine” before the homepage widget will actually work…why didn’t I think of that?
    Sarcasm aside, thanks for the awesome step-through!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.