Setup Mode: Local or Hybrid
Setup Mode tells Deployrr whether your apps are for your home network only (Local) or can also be reached from the internet (Hybrid). This guide helps you pick one, lists what Hybrid needs, and explains how Setup Mode differs from the Traefik and proxy settings.
Overview
Section titled “Overview”Setup Mode is an item in the Prerequisites menu. Its description reads Toggle how Apps are setup - Local or Toggle how Apps are setup - Hybrid. If you never set it, it shows Local.
It is a toggle. Each time you select it, it switches to the other mode and shows a Server Setup Mode box that says which mode is now enabled.
You can switch with any license. What each mode needs depends on your license. See Licenses.
Local or Hybrid
Section titled “Local or Hybrid”| Local | Hybrid | |
|---|---|---|
| Who can reach your apps | Your internal network only | Some or all apps can be reached from the internet through a reverse proxy |
| Domain name | Not required | Required |
| Reverse proxy, port forwarding, Cloudflare DNS, SSL mode, DNS records | Not required | Required |
| License | Basic, Plus or Pro | Plus or Pro (login apps need Pro) |
Pick Local if you only use your apps at home. Pick Hybrid if you want addresses such as https://app.YOUR_DOMAIN that also work from outside.
To see the two modes toggled on screen, watch Deployrr 5 walkthrough: Local vs Hybrid mode at 7:01 (shows Deployrr v5; menus differ in v6).
What Hybrid needs
Section titled “What Hybrid needs”When you switch to Hybrid, the box lists eight requirements:
- A domain name. It can come from any registrar.
- Deployrr Plus or Pro.
- A reverse proxy (Traefik).
- Port forwarding from your gateway, firewall or router to the Docker host, for ports 80 and 443.
- Cloudflare for DNS.
- A DNS A record for the domain that points to your WAN IP.
- A DNS CNAME record for
*that points to@. - Cloudflare SSL mode set to FULL.
Set the SSL mode to Full even though your DNS records stay gray cloud. See Orange cloud or gray cloud.
Meet these before you set up Traefik. See Set up Traefik. If Domain Checks fails, see Domain Checks failed.
To see the DNS records made by hand, watch Traefik 3 guide: Cloudflare A and CNAME DNS records at 7:35 (manual Docker Compose setup). To understand the same requirements in a manual setup, read UDMS part 18: Requirements for a Traefik setup (manual setup).
What Local needs
Section titled “What Local needs”The Server Setup Mode box for Local says apps are exposed on the internal network only. You need no reverse proxy, domain name, port forwarding, Cloudflare DNS, SSL mode or DNS records. It lists one requirement: Deployrr Basic, Plus or Pro.
In Local mode, these Prerequisites items show NOT-REQUIRED:
- Domain 1
- Domain Checks
Set the mode
Section titled “Set the mode”Do Disclaimers in Prerequisites first. If you did not, you see a Requirements Not Met box.
- From the main menu, select Prerequisites.
- Check the mode shown next to Setup Mode.
- Select Setup Mode.
- Read the Server Setup Mode box. It says
Hybrid mode ENABLEDorLocal mode ENABLED. - If you landed on the wrong mode, select Setup Mode again.
Recommended order of steps
Section titled “Recommended order of steps”Help > Usage shows the order Deployrr recommends. Deployrr tells you about any missing requirement at each step.
Local mode:
- Prerequisites.
- Make sure Local mode is enabled.
- Socket Proxy.
- Deployrr Dashboard.
- Apps.
Hybrid mode:
- Prerequisites.
- Make sure Hybrid mode is enabled.
- Socket Proxy.
- Traefik.
- Deployrr Dashboard.
- Google OAuth or Authelia.
- Apps.
What you see in Local mode
Section titled “What you see in Local mode”- Domain 1: a Domain Configuration box says
Domain is NOT REQUIRED in Local mode.You can still set a domain if you plan to use Hybrid later. - After you add a domain in Local mode, a Setup Mode Warning asks
Switch to Hybrid mode?Answer yes to switch. You then see a Setup Mode Changed box. Answer no to stay in Local. - Domain Checks: a Domain Checks Not Required box says
Domain checks are not required in Local mode. - Proxy > Proxy Type: a Proxy Type - Local Mode Warning box says no reverse proxy is used and changes have no effect until you switch to Hybrid. You can still continue.
In Hybrid mode, the Prerequisites status needs a domain and finished Domain Checks. In Local mode it does not.
Features that need Hybrid
Section titled “Features that need Hybrid”If Setup Mode is not Hybrid, these items show a Requirements Not Met box:
Hybrid Mode - Setup Mode must be Hybrid. Current: Local (Prerequisites menu)The items are:
- Traefik Preparation, Staging, Production and Manage Exposure
- NPM > Install (Nginx Proxy Manager)
- Security > Authelia, Authentik, Google OAuth, TinyAuth and Manage Auth
The box lists every missing item at once, so you may see the Hybrid line next to others, such as a license or Traefik not running. Switch to Hybrid in Prerequisites > Setup Mode, fix the other items, then try again. Deployrr shows “Requirements Not Met” explains every line the box can list.
Traefikify, Un-Traefikify and Traefik Mode don’t check Setup Mode. They have their own requirements.
Setup Mode, Traefik Mode and Proxy Type
Section titled “Setup Mode, Traefik Mode and Proxy Type”These are three separate settings.
| Setting | Where | What it decides |
|---|---|---|
| Setup Mode | Prerequisites | Local (home network only) or Hybrid (internet access through a reverse proxy) |
| Proxy Type | Proxy | Which reverse proxy you use: Traefik or Nginx Proxy Manager |
| Traefik Mode | Proxy > Traefik | Simple or Advanced: which ports you forward, and whether you can set each app to Internal, External or Both |
Set Setup Mode to Hybrid first. Then pick a proxy. Traefik Mode needs Proxy Type set to Traefik first.
- To use Traefik, follow Set up Traefik. Then choose a Traefik Mode with Simple vs Advanced Traefik mode.
- To use Nginx Proxy Manager instead, follow Use Nginx Proxy Manager instead of Traefik.
- Traefik needs a Plus or Pro license. The login apps need Pro. See Choose a login method.
Switch modes later
Section titled “Switch modes later”- Go to Prerequisites > Setup Mode.
- Select it once to switch.
- Read the Server Setup Mode box.
When you switch to Local, Deployrr clears your Proxy Type without a message. If you switch back to Hybrid, pick your proxy again in Proxy > Proxy Type.
Move a Local server to Hybrid
Section titled “Move a Local server to Hybrid”You can start in Local and add internet access later. Do these steps in order:
- Meet the Hybrid requirements first: the domain on Cloudflare, the DNS records, and ports 80 and 443 forwarded to the server. See Cloudflare for Deployrr and Port forwarding.
- Go to Prerequisites > Setup Mode and select it once. The box says
Hybrid mode ENABLED. - Set Domain 1 if it is empty. See Domain 1.
- Run Domain Checks. It needs System Checks done first. Run it before Traefik or Nginx Proxy Manager is running. See Domain Checks.
- Check that Prerequisites shows DONE again. In Hybrid mode it needs a domain and finished Domain Checks. So it shows NOT DONE after the switch until you finish steps 3 and 4. Until then, the Traefik steps show Requirements Not Met.
- Go to Proxy > Proxy Type and pick Traefik or NPM. Do this even if you picked one before: switching to Local cleared it.
- Set up your proxy. For Traefik, run Preparation, Staging and Production as in Set up Traefik. Socket Proxy must be running, and you need a Plus or Pro license.
If you set Domain 1 while still in Local mode, Deployrr asks Switch to Hybrid mode?. Answering yes does step 2 for you.
Setup Mode, Domain 1 and Proxy Type don’t stop your apps.
Apps you installed while Traefik was not running, as in Local mode, have no Traefik file, so their subdomains don’t open yet. Deployrr does not go back and add files for them. Add each one with Traefikify, as in The app has no Traefik file.
You can also run more than one server on one domain. The main server runs Hybrid and the others run Local. See Use one domain across several servers.
Next steps
Section titled “Next steps”- Picked Hybrid? Set up Traefik.
- Check what your license unlocks in Licenses.

