Requirements
Supported systems
| System | Status |
|---|---|
| Ubuntu 26.04, native or WSL2 | ✅ Supported. CI runs the full playbook on a clean 26.04 runner weekly and on every push to master. The Docker image is built on 26.04. See the sudo note below. |
| Ubuntu 24.04, native or WSL2 | ✅ Supported, but no longer tested in CI. |
| Other Ubuntu releases | ⚠️ Not tested. They may work, but nothing checks them. |
| Other distributions, macOS | ❌ Not supported. The roles use apt and Ubuntu packages. On those systems, use the Docker image. |
| Windows host | ⚠️ Experimental. See Windows setup. |
Only x86_64 (amd64) is supported. Many tools are downloaded as amd64 builds.
Terminal and font
Any terminal works. A font with Nerd Fonts icons is recommended. A sample font (FiraCode Nerd Font) is in ansible/roles/windows/files/fonts. Without such a font, turn the icons off with nerd_fonts.
Network
The playbook downloads from GitHub, the Ubuntu mirrors and the tools' own sites. A full run makes about 33 GitHub API calls. Without a token, GitHub allows 60 per hour, so set up a token first (gh auth login, or GITHUB_TOKEN). See GitHub API rate limits.
Behind a TLS-intercepting proxy, see Unable to get HTTPS endpoints.
WSL2
When running Ubuntu on Windows with WSL2, also make sure you have:
- Windows 10 version 2004 or later (build 19041 or later), or Windows 11
- WSL2 installed and enabled (version 0.67.6 or later)
- Ubuntu 24.04 or 26.04 installed
systemdenabled in the Ubuntu distribution (the default for new installs)
note
On WSL2, check your Windows setup by going through Windows manual setup.