Advertisement
Tutorials

How to Install Guardian on Your Synology NAS

Advertisement
Guardian Synology Install 2026: Quick Overview
  • • Guardian v1.3.4 gives real-time control over Plex streams
  • • Get your Plex token in 30 seconds via browser Developer Tools
  • • Deploy with Docker Compose via Portainer in under 5 minutes
  • • Monitor active streams and terminate unwanted sessions
  • • Set per-user access policies and temporary permissions
  • • Works on Synology, UGREEN, and any Docker‑capable NAS

Looking for a complete Guardian Synology install 2026 guide? You’ve come to the right place. Guardian is a lightweight companion app for Plex Media Server that lets you monitor, approve, or block streaming devices in real time. In this step‑by‑step tutorial, I’ll show you exactly how to get it running on your Synology NAS using Docker and Portainer.

💡 What Guardian does: It enables enforcing per‑user or global access policies, automatically terminating unwanted sessions, and granting temporary access, all through a clean and simple web interface. Think of it as your Plex bouncer.
5 min Installation time
Real-time Session monitoring
1-click Stream termination
Free Open source

📋 Prerequisites for Guardian Synology Install 2026

⚠️ Before you begin: This guide assumes you have a working Synology NAS with Docker support. If you’re unsure about compatibility, check our best NAS for Docker guide.

🏆 Recommended NAS for Plex + Guardian

Synology DS224+ – Best for Plex Beginners
★★★★★ (8,775 reviews)
$299.99
✅ Free Prime Shipping
🛒 Check Price on Amazon
As an Amazon Associate, HomeCloudHQ earns from qualifying purchases.
Synology DS423+ – 4‑Bay for Growing Libraries
★★★★★ (4,567 reviews)
$379.99
✅ Free Prime Shipping
🛒 Check Price on Amazon
As an Amazon Associate, HomeCloudHQ earns from qualifying purchases.
💡 Note: This Guardian Synology install 2026 guide works perfectly with the latest Guardian v1.3.4 release.
💡 Note: Check out our guide on how to Install Guardian on Your UGREEN NAS.

🔑 Step 1: Get Your Plex Token for Guardian Synology Install 2026

Guardian needs a Plex token to communicate with your server. Here’s how to find it:

  1. Connect to your Plex instance and go to Home
  2. Press F12 on your keyboard to open Developer Tools
  3. Expand the window and click the Network tab
  4. In the filter field, type library
  5. Click the red record button to stop recording, then click Start to begin fresh recording
  6. Click Reload page
  7. In the Network tab, click on the first entry that appears
  8. Look for your Plex token between = and & in the URL parameters
  9. Copy and save this token – you’ll need it later
Guardian Synology NAS Set up 1 - Network tab instructions
Network tab and filter “library”
Guardian Synology NAS Set up 2 - Start recording
Click Start to begin recording
Guardian Synology NAS Set up 3 - Reload page
Reload the page to capture network activity
Guardian Synology NAS Set up 4 - Copy Plex token
Copy the token between = and &
💡 Pro tip: Your Plex token is like a password – keep it secure. Anyone with this token can access your Plex server.

📁 Step 2: Create the Guardian Folder

  1. Open File Station in DSM
  2. Navigate to the docker shared folder
  3. Create a new folder named guardian (all lowercase)
Guardian Synology NAS Set up 5 - Create folder in File Station
Create a new folder named “guardian”
⚠️ Important: The folder name must be exactly “guardian” in lowercase. Docker is case‑sensitive.

🐳 Step 3: Deploy Guardian Using Portainer

  1. Log into Portainer using your credentials
  2. On the left sidebar, click Home then Live connect
  3. Click Stacks+ Add stack
  4. Name your stack: guardian
Portainer Add Stack NAS 1 - Live connect
Portainer Home → Live connect
Portainer Add Stack NAS 2 - Add stack
Click Stacks → + Add stack
💡 Note: Copy and paste the code below into the Portainer Stack Web editor.
services:
  backend:
    image: hydroshieldmkii/guardian-backend:latest
    container_name: Guardian-BACKEND
    environment:
      NODE_ENV: production
      DATABASE_PATH: /app/data/plex-guard.db
    volumes:
      - /volume1/docker/guardian:/app/data:rw
    restart: on-failure:5

  frontend:
    image: hydroshieldmkii/guardian-frontend:latest
    container_name: Guardian-FRONTEND
    ports:
      - 3037:3000
    environment:
      NODE_ENV: production
    depends_on:
      - backend
    restart: on-failure:5
  
Guardian Synology NAS Set up 6 - Paste code in Portainer
Paste the docker-compose code in the web editor
  1. Scroll down and click Deploy the stack
  2. Wait for the deployment to complete (1‑2 minutes depending on your internet speed)
Guardian Synology NAS Set up 7 - Deploy stack button
Click Deploy the stack
✅ Success message: You should see “Success Stack successfully deployed” in the top right corner.
Portainer Success Stack NAS
Success message after deployment

⚙️ Step 4: Initial Configuration

  1. Open your browser and navigate to: http://[YOUR_SYNOLOGY_IP]:3037
  2. Create your administrator account and click Create Admin Account
  3. Click Go to settings
Guardian Synology NAS Set up 8 - Create admin account
Create your administrator account
Guardian Synology NAS Set up 9 - Go to settings
Click Go to settings

🔌 Step 5: Connect Guardian to Your Plex Server

  1. In the settings page, fill in the following:
    • Custom Plex URL: http://[YOUR_SYNOLOGY_IP]:32400/web
    • Plex server token: [paste the token from Step 1]
    • Plex server IP address: [YOUR_SYNOLOGY_IP]:32400/web (without http://)
    • Plex server port: 32400
  2. Click Save Now
  3. Click Test Plex Connection to verify everything works
Guardian Synology NAS Set up 10 - Enter Plex details
Fill in your Plex URL, token, IP and port
Guardian Synology NAS Set up 11 - Test connection
Click Save Now then Test Plex Connection
🔍 What’s happening here? Guardian uses your Plex token to authenticate and monitor your server. The IP address tells Guardian where to find your Plex instance. The port 32400 is the default Plex communication port.

🎉 Step 6: You’re Done!

Your Guardian Synology install 2026 is now complete. You’ll see two main views:

Advertisements
  • Device Management: Overview of all devices that have accessed your Plex server
  • Active Streams: Real‑time view of what’s currently playing, with options to terminate streams
Guardian Synology NAS Set up 12 - Device Management
Guardian Device Management view
Guardian Synology NAS Set up 13 - Active Streams
Guardian Active Streams view

⚖️ Why Guardian Matters

Plex doesn’t give you fine‑grained control over who streams what, or when. Guardian fills that gap. You can now:

  • ✅ See exactly who’s streaming in real time
  • ✅ Terminate unwanted sessions with one click
  • ✅ Set access policies per user or device
  • ✅ Grant temporary access without sharing your Plex password
🔐
500GB FREE to Start

Back Up Your Guardian & Plex Configuration

Your Plex server represents hundreds of hours of curation. Don’t lose your settings, watch history, or user data. pCloud’s client‑side encryption keeps your backups private, and lifetime plans eliminate monthly fees forever.

🔒 Get 500GB Free – pCloud Encryption

🔧 Troubleshooting Common Issues

Can’t access Guardian on port 3037

Check that the container is running in Portainer. Also verify your firewall settings – port 3037 must be open on your NAS and router if accessing remotely. For local access, ensure you’re using the correct IP address.

“Failed to connect to Plex” error

Double‑check your Plex token – it’s the most common issue. Also verify that your Plex server is running and accessible at the IP address you provided. Try accessing http://[YOUR_IP]:32400/web directly in your browser to confirm.

Advertisement
Guardian shows no active streams when Plex is playing

Make sure your Plex token has admin privileges. The token from the web interface (as shown in Step 1) should work, but if issues persist, try generating a new token by signing out and back into Plex.

📚 Additional Docker Resources

🔗 Official Links

Ready to Take Control of Your Plex Server?

Guardian gives you the power to manage who watches what, when. Install it today and never wonder “who’s streaming?” again.

🏆 Get Synology DS224+ – Best for Plex 🔒 Back Up with pCloud

Last updated: February 22, 2026 | Tested on DSM 7.2 with Guardian v1.3.4 | This post contains Amazon Associates and pCloud affiliate links – see our disclosure.

Advertisement

Leave a Reply

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

Back to top button