intuneme¶
Run Microsoft Intune on an immutable Linux host — without touching the host system.
How it works¶
intuneme provisions and manages a systemd-nspawn container running Ubuntu 24.04. Inside the container, a full systemd instance runs as PID 1 with its own D-Bus buses, gnome-keyring, and user session. Intune Portal, the Microsoft Identity Broker, and Microsoft Edge all run inside this isolated environment.
The host provides display, audio, and GPU access through targeted bind mounts. A dedicated ~/Intune directory on the host serves as the container user's home — preserving enrollment state, browser profiles, and downloads across container rebuilds.
graph LR
subgraph Host
cli["intuneme CLI"]
home["~/Intune/"]
display["Display\n(X11 / Wayland)"]
audio["Audio\n(PipeWire)"]
gpu["/dev/dri\n/dev/nvidia*"]
devices["USB / Video\n(hotplug)"]
proxy["broker-proxy\n(opt-in)"]
end
subgraph Container ["Container (systemd-nspawn)"]
systemd["systemd (PID 1)"]
broker["microsoft-identity-broker"]
device_broker["microsoft-identity-device-broker"]
agent["intune-agent (timer)"]
keyring["gnome-keyring"]
apps["Edge / Intune Portal"]
end
home -->|bind mount| systemd
display -->|bind mount| systemd
audio -->|bind mount| systemd
gpu -->|bind mount| systemd
devices -->|nsenter hotplug| systemd
cli -->|machinectl / nsenter| systemd
proxy <-->|D-Bus forwarding| broker
systemd --> broker
systemd --> device_broker
systemd --> agent
systemd --> keyring
systemd --> apps
Key features¶
- Container lifecycle management —
init,start,stop,destroy, andrecreatecommands handle the full container lifecycle, including image pulls, user provisioning, and enrollment-safe upgrades. - Broker proxy (host-side SSO) — An opt-in D-Bus forwarding proxy lets host apps (Edge, VS Code) authenticate via the container's Intune enrollment — no re-authentication needed on the host.
- Device hotplug — YubiKey USB security keys and webcams are automatically forwarded into the container via udev rules. Plug in, plug out; the container tracks it.
- GNOME Quick Settings extension — A one-click toggle in GNOME Quick Settings starts or stops the container and provides shortcuts to launch Edge and Intune Portal.
- Nvidia GPU support — Nvidia GPUs are auto-detected at boot. Host driver libraries, device nodes, and Vulkan/EGL vendor files are forwarded into the container — no manual setup required.
- Desktop shortcuts —
.desktopentries for Edge and Intune Portal integrate with the GNOME application grid so you can launch corporate apps like any other app. - Auto-generated CLI reference — Full command and flag documentation generated from the source.