Agent Installation

The Ambient endpoint agent connects each device to your tenant and applies wallpapers, lock screens, screensavers, signatures, and policy settings.

Windows

NSIS Installer (Recommended)

1. Download Ambient-Agent-Setup-latest.exe from the download page.
2. Run the installer — it will install silently with default options.
3. The agent starts automatically after installation.
4. Open the system tray icon and enter your enrollment code to register the device.

Silent Install (Enterprise)

Ambient-Agent-Setup-latest.exe /S

For pre-configured deployment, place agent-config.json at:

C:\ProgramData\Ambient\agent-config.json

The agent reads this file on first launch and auto-registers without prompting.

MSI Package

An MSI package is available for SCCM, Intune, and GPO deployments. See the Admin Deployment Guide.

Linux

Debian / Ubuntu (deb)

sudo dpkg -i ambient-agent_latest_amd64.deb
sudo systemctl enable --now ambient-agent

Config path: /etc/ambient/agent-config.json

AppImage

chmod +x ambient-agent_latest_x86_64.AppImage
./ambient-agent_latest_x86_64.AppImage

Config path: ~/.config/ambient/agent-config.json

Verifying the Installation

After installation the agent icon appears in the system tray (Windows) or notification area (Linux). The status shows Registered once the device has connected to your tenant.

Troubleshooting

• Agent not registering: Verify the enrollment code in Settings → Endpoints → Enrollment Codes.
• Agent offline after install: Check your firewall allows outbound HTTPS to the Ambient API (api.ziviso.africa:443).
• Windows: installer blocked by SmartScreen: Click “More info” → “Run anyway” or use the enterprise MSI for GPO-signed deployment.