Skip to content

Deployrr shows "Requirements Not Met"

TroubleshootingDeployrr v6.0+CurrentInstallTraefikAuthenticationDocker

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.

  1. Read every line in the box. Close the box.
  2. Find each line in the tables below.
  3. Do what the “Where to clear it” column says.
  4. Select the same menu item again.
  5. If a new box appears, repeat from step 1. Some items show a different box once the first one is clear.
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.

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.

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.

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.

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.

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.
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).

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

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 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 first

Install 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 LXC

In 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.
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.

  1. Select the menu item again.
  2. The Requirements Not Met box does not appear.
  3. 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.