Privileged Mode (Nested Containers)
DevBoxes normally launch hardened — Linux capabilities dropped, no /dev/fuse, and network isolated according to their security profile. That hardening is exactly what blocks running a container engine inside a DevBox: podman or docker fails there because there’s no /dev/fuse, no CAP_SYS_ADMIN, and no sub-UID delegation.
Privileged mode is an opt-in escape hatch for that one case. When enabled, the DevBox launches with --privileged, giving it full root-equivalent access to the worker machine’s container engine — which is what makes nested containers (“container-in-container”) work. It is available only on BYOM workers (your own machines), never on Cloud workers.
When to use it
Section titled “When to use it”Reach for privileged mode only when the work inside the DevBox needs its own container engine — for example:
- Testing container builds —
podman build/docker buildfrom inside the DevBox - Running a nested test rig — a container-based integration suite that spins up its own containers
- Container-in-DevBox development — anything that shells out to
podman run/docker run
If your workload doesn’t run containers itself, you don’t need this — stay on a hardened security profile.
Who can use it
Section titled “Who can use it”Privileged launches are gated. The toggle only appears — and the launch is only accepted — for:
- The owner of the machine — whoever registered that BYOM worker, or
- A tenant admin or owner
Everyone else (members on a machine they don’t own) won’t see the toggle, and a privileged launch request from them is rejected. Cloud-worker launches reject privileged mode unconditionally, for anyone.
Constraints
Section titled “Constraints”- BYOM workers only. The toggle is hidden until you select a BYOM worker as the launch target, and Cloud-worker launches reject it.
- Forces the Open profile. Privileged mode is incompatible with sandbox hardening, so turning it on auto-selects the Open security profile and disables the profile picker while the toggle is on. Turn the toggle off to change the profile again.
- Eligible users only. See Who can use it above.
Enable it at launch
Section titled “Enable it at launch”The toggle lives in both launch surfaces. In each, it only appears after you’ve selected a BYOM worker as the target, and only if you’re eligible.
From Quick Launch
Section titled “From Quick Launch”-
Open the Quick Launch side panel.
-
In the target picker, select a BYOM worker (your own machine). The privileged option only appears for BYOM targets.
-
Scroll the panel to find Privileged mode (nested containers) and switch it on.
-
Confirm the profile is now Open (it’s selected automatically and locked while privileged is on).
-
Launch.
From the Launch page
Section titled “From the Launch page”-
Open the full Launch page and select a BYOM worker as the target.
-
Expand Advanced Options.
-
Switch on Privileged mode (nested containers).
-
Confirm the security profile is now Open and locked.
-
Launch.
After launch
Section titled “After launch”A DevBox launched in privileged mode shows a Privileged badge on its detail page, so it’s easy to spot which DevBoxes are running unhardened. From inside the DevBox you can now run a container engine — for example, building or running containers with podman or docker.
Reference
Section titled “Reference”| What | Rule |
|---|---|
| Worker type | BYOM only — never Cloud workers |
| Who | Machine owner (registered the worker) or tenant admin/owner |
| Security profile | Forced to Open; picker disabled while enabled |
| Effect | Launches the DevBox with --privileged (podman/Docker parity) |
| Badge | Privileged badge on the DevBox detail page |
Related
Section titled “Related”- Security Profiles — the hardening privileged mode turns off
- Workers — self-hosted (BYOM) vs Cloud workers
- DevBoxes
- Cloud workers — where privileged mode is never available