Deployrr shows "Requirements Not Met"
Symptoms
Section titled “Symptoms”You select a menu item or confirm an app install. Nothing runs. Instead you see a box with this title and text:
Requirements Not Met (3)
The following requirements must be met before continuing:
• Prerequisites - All steps must be completed• Hybrid Mode - Setup Mode must be Hybrid. Current: Local (Prerequisites menu)• License - Plus or Pro required. Current: Free (Prerequisites->Verify)The number in the title is how many lines the box lists. Each line names one missing item. Most lines end with the menu that fixes it.
The item you picked needs other steps done first. Deployrr checks them before it starts. It lists every missing step in one box, so you can fix them all in one pass.
This box is not the same as the License Required box that says ACCESS DENIED. See How it differs from License Required.
- Read every line in the box. Close the box.
- Find each line in the tables below.
- Do what the “Where to clear it” column says.
- Select the same menu item again.
- If a new box appears, repeat from step 1. Some items show a different box once the first one is clear.
Prerequisites lines
Section titled “Prerequisites lines”| Line in the box | What it means | Where to clear it |
|---|---|---|
Disclaimers - Must be read and acknowledged (Prerequisites menu) |
You have not accepted the disclaimers. | Prerequisites > Disclaimers. Read the box and select Yes. |
Docker Folder - Must be set (Prerequisites menu) |
No Docker folder is chosen. | Prerequisites > Docker Folder. |
Docker Environment - Must be set up (Prerequisites menu) |
The Docker folder structure is not built. | Prerequisites > Environment. |
Username - A non-root Linux user must be set (Prerequisites menu) |
No Linux user is set, or the user is root. |
Prerequisites > Username. |
Domain Name - Must be configured (Prerequisites menu) |
No primary domain is set. | Prerequisites > Domain 1. |
System Checks - Must be completed (Prerequisites menu) |
System Checks has not finished. | Prerequisites > System Checks. |
Prerequisites - All steps must be completed |
At least one Prerequisites step is not done. This line has no menu hint. | Open Prerequisites. Finish every item that shows NOT DONE, NOT SET, NOT-SET or EXPIRED. See the next section. |
The Prerequisites line is the one you see most. It is not one step. It means the whole Prerequisites menu must be finished.
What counts as “all steps”
Section titled “What counts as “all steps””Open Prerequisites and look at each line. Some items show DONE when finished. Others show their value, such as SET with a path, your username or your IP. An item still to do shows NOT DONE, NOT SET, NOT-SET or EXPIRED. These must be finished:
- Disclaimers
- Packages
- Build Cache. If it says
EXPIRED, run it again. - Username
- System Type
- Docker Folder
- Backups Folder
- Environment
- Server IP
- System Checks
- Telemetry
- Verify. Run it and enter your email.
In Hybrid mode, Domain 1 and Domain Checks must be done too. In Local mode they show NOT-REQUIRED. Setup Mode itself needs no value, because it always shows Local or Hybrid. Follow the Quick start for the order, and see Prerequisites, step by step for what each step asks and changes. To see the Prerequisites menu worked through, watch Deployrr 5 walkthrough: Prerequisites menu at 5:31 (shows Deployrr v5; menus and steps differ in v6).
Which Prerequisites steps need another step first
Section titled “Which Prerequisites steps need another step first”Some Prerequisites items show Requirements Not Met themselves:
| You select | It needs first |
|---|---|
| Packages, Build Cache, Username, System Type, Setup Mode, Docker Folder, Backups Folder, Telemetry | Disclaimers |
| Environment | Disclaimers, Docker Folder |
| Server IP, Domain 1 | Disclaimers, Docker Environment |
| System Checks | Disclaimers, Username |
| Domain Checks | Disclaimers, Username, Domain Name, System Checks |
| Verify | Disclaimers, Docker Folder |
So the safe order is: Disclaimers, Packages, Build Cache, Username, System Type, Docker Folder, Backups Folder, Environment, Server IP, Domain 1, System Checks, Domain Checks, Verify, Telemetry.
License lines
Section titled “License lines”| Line in the box | What it means | Where to clear it |
|---|---|---|
License - Basic, Plus, or Pro required. Current: ... (Prerequisites->Verify) |
The item needs a paid license. | Upgrade, then run Prerequisites > Verify. |
License - Plus or Pro required. Current: ... (Prerequisites->Verify) |
The item needs Plus or Pro. | Same. |
License - Pro required. Current: ... (Prerequisites->Verify) |
The item needs Pro. | Same. |
Current: shows the license Deployrr sees on this server. If you already upgraded, run Verify again. See Licenses for what each level unlocks.
Setup Mode line
Section titled “Setup Mode line”| Line in the box | What it means | Where to clear it |
|---|---|---|
Hybrid Mode - Setup Mode must be Hybrid. Current: Local (Prerequisites menu) |
The item only works in Hybrid mode. | Prerequisites > Setup Mode. Select it until the box says Hybrid mode ENABLED. |
See Setup Mode: Local or Hybrid for what Hybrid needs.
Traefik and Docker lines
Section titled “Traefik and Docker lines”| Line in the box | What it means | Where to clear it |
|---|---|---|
Socket Proxy - Must be running (Docker menu) |
Socket Proxy is not installed or not running. | Docker > Socket Proxy. The menu line shows RUNNING when it is ready. See Socket Proxy. |
Traefik Preparation - Must be completed (Proxy menu) |
Preparation has not finished. | Proxy > Traefik > Preparation. |
Traefik Staging - Must be completed (Proxy menu) |
Staging has not finished. | Proxy > Traefik > Staging. |
Traefik Production - Must be completed (Proxy menu) |
Production has not finished. You also see this after you run Staging again, or after a Production rerun that did not finish: both clear the Production - DONE mark. |
Proxy > Traefik > Production. See Run the steps again. |
Traefik - Must be running (Proxy menu) |
The Traefik container is not running. | Finish Production. If it was done before and Traefik stopped, see Read the Traefik logs. |
The full Traefik order is in Set up Traefik.
Security lines
Section titled “Security lines”| Line in the box | What it means | Where to clear it |
|---|---|---|
CrowdSec - Must be running (Security menu) |
CrowdSec is not running. | Security > CrowdSec. |
Advanced Authentication - Authelia, Authentik, OAuth, or TinyAuth must be running (Security menu) |
No login app is running. One of the four is enough. OAuth means Google OAuth. |
Security > Authelia, Authentik, Google OAuth or TinyAuth. See Choose a login method. |
System lines
Section titled “System lines”| Line in the box | What it means | Where to clear it |
|---|---|---|
Network Adapter - Must be configured (System menu) |
The network adapter for VPN apps is not set up. | System > Network. |
Rclone - Must be installed (System->Rclone menu) |
Rclone is missing. | System > Mounts > Rclone > Install. |
SMB Remote - At least one must be configured (System->Rclone menu) |
No Rclone remote exists. | System > Mounts > Rclone > SMB Remote. |
SMB Remote - At least one must be mounted (System->Rclone menu) |
No Rclone remote is mounted. | System > Mounts > Rclone > Automount. See Mount a NAS share with Rclone. |
To see the Rclone menu used from install to automount, watch Deployrr 5 walkthrough: Rclone setup and mounting at 17:08 (shows Deployrr v5; menus and steps differ in v6).
Folder lines
Section titled “Folder lines”These appear when you install an app that needs a folder. Set the folder in System > Folders. Setting a folder needs a Basic, Plus or Pro license. See Set your media, downloads and other folders for every folder and which apps use it.
| Line in the box | Where to clear it |
|---|---|
Media Folder - At least one media folder must be set (System > Folders menu) |
Media Folder 1, 2 or 3. One is enough. |
Downloads Folder - Must be set (System > Folders menu) |
Downloads Folder |
Books Folder - Must be set (System > Folders menu) |
Books Folder |
Audiobooks Folder - Must be set (System > Folders menu) |
Audiobooks Folder |
Podcasts Folder - Must be set (System > Folders menu) |
Podcasts Folder |
Comics Folder - Must be set (System > Folders menu) |
Comics Folder |
Photos Folder - Must be set (System > Folders menu) |
Photos Folder |
Games Folder - Must be set (System > Folders menu) |
Games Folder |
Immich Folder - Must be set (System > Folders menu) |
Immich Folder |
Nextcloud Folder - Must be set (System > Folders menu) |
Nextcloud Folder |
What each menu item needs
Section titled “What each menu item needs”This table shows which lines each item can list. Prerequisites means the Prerequisites - All steps must be completed line.
| Menu item | Can list |
|---|---|
| Docker > Docker Login, Disk Usage, Cleanup | Prerequisites |
| System > GPU, Network, SMTP, Mail Relay; Mounts > SMB Mount, NFS Mount; Rclone > Install, Uninstall | Prerequisites, Basic, Plus or Pro license |
| System > Bash Aliases | Disclaimers, Username, Docker Environment, Basic, Plus or Pro license |
| System > Folders (each folder item) | Prerequisites, Basic, Plus or Pro license |
| System > Mounts > Rclone > SMB Remote | Prerequisites, Basic, Plus or Pro license, Rclone installed |
| System > Mounts > Rclone > Automount | Prerequisites, Basic, Plus or Pro license, Rclone installed, SMB Remote configured |
| System > Mounts > Rclone > Delay Media Apps, Refresh Cache | Prerequisites, Basic, Plus or Pro license, Rclone installed, SMB Remote configured, SMB Remote mounted |
| Tools > Stack Manager, Lazydocker (see Lazydocker on Docker v29), Diagnostics, Dashify, ReDash | Prerequisites, Basic, Plus or Pro license |
| Tools > Backups (Backup, View, Delete, MP Create), .env Editor, Secrets Editor, Change Hostname, Change Server IP; Settings > Version Pins | Prerequisites, Pro license |
| Tools > Backups > Restore | Disclaimers, Pro license |
| Tools > Backups > MP Restore | Pro license |
| Proxy > Traefik > Traefik Mode | Disclaimers |
| Proxy > Traefik > Preparation | Prerequisites, Hybrid, Socket Proxy, Plus or Pro license |
| Proxy > Traefik > Staging | Prerequisites, Socket Proxy, Hybrid, Traefik Preparation, Plus or Pro license |
| Proxy > Traefik > Production | Prerequisites, Socket Proxy, Traefik Preparation, Hybrid, Traefik Staging, Traefik running, Plus or Pro license |
| Proxy > Traefik > Manage Exposure | Prerequisites, Socket Proxy, Traefik Production, Traefik running, Hybrid, Plus or Pro license |
| Proxy > Traefik > Traefikify, Un-Traefikify, Domain Passthrough, Auth Bypass | Prerequisites, Socket Proxy, Traefik Production, Traefik running, Plus or Pro license |
| Proxy > NPM > Install | Prerequisites, Hybrid |
| Security > Authelia, Authentik, Google OAuth, TinyAuth | Prerequisites, Socket Proxy, Traefik Production, Traefik running, Hybrid, Pro license |
| Security > Manage Auth | Prerequisites, Traefik Production, Traefik running, Hybrid, Pro license |
| Security > CrowdSec | Prerequisites, Pro license |
| Security > Firewall Bouncer | Prerequisites, CrowdSec running, Pro license |
| Security > Traefik Bouncer | Prerequisites, CrowdSec running, Traefik running, Pro license |
| Apps > ShellInABox | Prerequisites, Traefik Production, Advanced Authentication, Basic, Plus or Pro license |
| Help > Request Pin, Reset Pin | Disclaimers |
| Feedback | Disclaimers, Basic, Plus or Pro license |
Traefik Mode and Traefikify never list the Hybrid Mode line. Traefik Mode also needs Proxy > Proxy Type set to Traefik. If it is not, you see a Proxy Type Required box that says Go to: Proxy -> Proxy Type. See Set up Traefik.
NPM > Install works the same way: Proxy Type must be NPM, or you see Proxy Type Required. Traefik must also be stopped, or you see Port Conflict - Cannot Install. See Use Nginx Proxy Manager instead of Traefik.
When you install an app
Section titled “When you install an app”When you install an app from Apps > Browse Apps, the box lists one line at a time. Fix it and start the install again. If another line is missing, the box appears again.
Every app needs the Prerequisites line. Some apps need more:
| App needs | Examples |
|---|---|
| Media Folder | Sonarr, Radarr, Lidarr, Bazarr, Navidrome |
| Downloads Folder | qBittorrent, SABnzbd, NZBGet, Prowlarr, Jackett, Transmission |
| Books Folder | Calibre, Calibre-Web, Kavita, Komga |
| Comics Folder | Komga, Mylar3 |
| Audiobooks Folder and Podcasts Folder | Audiobookshelf |
| Photos Folder | Piwigo |
| Games Folder | GameVault |
| Immich Folder | Immich |
| Nextcloud Folder | Nextcloud |
| Network Adapter | Gluetun, Tailscale, ZeroTier, Cloudflare Tunnel |
| Traefik Production | PrivateBin, Traefik Access Log, Traefik Error Log |
| Traefik Production and Advanced Authentication | ShellInABox |
An app that needs another app running, such as the Deployrr Dashboard, shows a message in the terminal instead of a box:
✗ Required app not running[REQUIRED] socket-proxy must be installed and running firstInstall the named app first. For Socket Proxy, use Docker > Socket Proxy.
An app that only runs on some kinds of server stops with this message in the terminal:
✗ System type not compatible[REQUIRED] Compatible with: Bare Metal VPS Virtual Machine Privileged LXC[CURRENT] Your system: Unprivileged LXCIn v6, only Kasm has this limit. [CURRENT] is what you picked in Prerequisites > System Type.
- If that choice is wrong, select Prerequisites > System Type again and pick the type that matches your server. Then start the install again.
- If you really run an Unprivileged LXC, Kasm can’t run there. Use a VM or a VPS for Kasm.
- If Kasm stops on a Virtual Machine, Privileged LXC or Barebones server, follow the steps in Run Deployrr in a Proxmox LXC container: Kasm.
How it differs from License Required
Section titled “How it differs from License Required”| Requirements Not Met | License Required | |
|---|---|---|
| Box title | Requirements Not Met (N) |
License Required |
| First text | The following requirements must be met before continuing: |
ACCESS DENIED |
| What it lists | Every missing item, with the menu that fixes it | Only your license, and the level you need |
| Where you see it | Traefik, Security, System, Tools, Settings and most menu items | Installing Socket Proxy, Deployrr Dashboard, NPM and apps from Apps > Browse Apps |
When you install Socket Proxy, the Deployrr Dashboard or an app from Browse Apps, the license is checked first. A Free license shows License Required before Deployrr checks anything else. Fix the license, then you may see Requirements Not Met.
NPM > Install is the other way round. It shows Requirements Not Met and Proxy Type Required first, and License Required only once those pass.
For the license box and how to upgrade, see Licenses. For Nginx Proxy Manager, see Use Nginx Proxy Manager instead of Traefik.
Check it worked
Section titled “Check it worked”- Select the menu item again.
- The Requirements Not Met box does not appear.
- The item starts, or asks its first question.
If you see a different box, such as Proxy Type Required or License Required, fix what it says. Then try again.

