Depl0y: install and first setup
For the admin who installs Depl0y: where it runs and what it must reach, what the installer does, the first sign-in (admin/admin, change it, enable TOTP), Admin/Operator/Viewer roles and per-host scoping, the encryption key in /etc/depl0y/config.env, connecting a Proxmox endpoint with an API token (and why privilege separation is unchecked), attaching iDRAC/iLO BMCs per node, the optional cloud-image, inter-node SSH and PBS setup, and safe upgrades and backups.
- Level
- Intermediate
- Length
- About 50 minutes
- Contents
- 3 lessons · 1 video · final exam
- Status
- Published · updated 2 Oct 2026
- Depl0y · open source
Skills you'll practise
- Prepare a host for Depl0y that meets the documented requirements and network reachability
- Install Depl0y with the supported installer and describe what it sets up
- Secure the first sign-in with a new password, TOTP and the right roles for each person
- Connect a Proxmox cluster with an API token and explain the trade-off of disabled privilege separation
- Attach a node's iDRAC or iLO BMC and check that it reports
- Back up config.env and the database together before an upgrade
Course outline
- 1.Depl0y: install and first setupVideo · 2 min
- 2.Plan the host and run the installerLesson · 15 min
- 3.First sign-in, accounts and secretsLesson · 15 min
- 4.Connect Proxmox and BMCs, then keep it updatedLesson · 20 min
- 5.Depl0y: install and first setup: knowledge checkKnowledge check · 15 questions
- 6.Final exam9 questions · passing it completes the course, so people who already know the material can test out
Sources it draws on
The lessons and questions are written from these references, so learners can go back to the original.
- Depl0y README (requirements, quick start, known limitations, security, upgrades and backups)
- Depl0y docs: Quick start (requirements, install, Proxmox endpoint, permissions, BMCs, troubleshooting)
- Depl0y INSTALL.md (installer, after installation, troubleshooting, uninstall)
- Depl0y docs: Installation (supported installer vs Docker Compose path)
- Depl0y docs: Architecture and internals (background jobs, caching, state on disk, configuration)
- Depl0y: Proxmox API tokens (creating, using and revoking a token)
- Depl0y SECURITY.md (security best practices, API token lifetimes)
- Depl0y: Cloud images complete guide (templates, cloud-init, troubleshooting)
- MSP Zero: Depl0y tool page (first deployment, know before you deploy)
- MSP Zero: Self-hosting (first-deployment advice, backups of keys with databases)
- Proxmox VE wiki: User Management (API tokens and privilege separation)
See it with your own jobs and topics
Tell us about your team and we'll walk you through setup, from choosing jobs to your first skills check.