Skip to content

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.

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

When you switch to Hybrid, the box lists eight requirements:

  1. A domain name. It can come from any registrar.
  2. Deployrr Plus or Pro.
  3. A reverse proxy (Traefik).
  4. Port forwarding from your gateway, firewall or router to the Docker host, for ports 80 and 443.
  5. Cloudflare for DNS.
  6. A DNS A record for the domain that points to your WAN IP.
  7. A DNS CNAME record for * that points to @.
  8. 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).

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

Do Disclaimers in Prerequisites first. If you did not, you see a Requirements Not Met box.

  1. From the main menu, select Prerequisites.
  2. Check the mode shown next to Setup Mode.
  3. Select Setup Mode.
  4. Read the Server Setup Mode box. It says Hybrid mode ENABLED or Local mode ENABLED.
  5. If you landed on the wrong mode, select Setup Mode again.

Help > Usage shows the order Deployrr recommends. Deployrr tells you about any missing requirement at each step.

Local mode:

  1. Prerequisites.
  2. Make sure Local mode is enabled.
  3. Socket Proxy.
  4. Deployrr Dashboard.
  5. Apps.

Hybrid mode:

  1. Prerequisites.
  2. Make sure Hybrid mode is enabled.
  3. Socket Proxy.
  4. Traefik.
  5. Deployrr Dashboard.
  6. Google OAuth or Authelia.
  7. Apps.
  • 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.

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.

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.

  1. Go to Prerequisites > Setup Mode.
  2. Select it once to switch.
  3. 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.

You can start in Local and add internet access later. Do these steps in order:

  1. 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.
  2. Go to Prerequisites > Setup Mode and select it once. The box says Hybrid mode ENABLED.
  3. Set Domain 1 if it is empty. See Domain 1.
  4. Run Domain Checks. It needs System Checks done first. Run it before Traefik or Nginx Proxy Manager is running. See Domain Checks.
  5. 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.
  6. Go to Proxy > Proxy Type and pick Traefik or NPM. Do this even if you picked one before: switching to Local cleared it.
  7. 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.