Skip to main content
Version: stable

software

This role installs the tools. Each row below is one task file in ansible/roles/software/tasks/. Its name is both the tag (--tags <name>, see Run particular code) and the exclude name (software_tasks_exclude, see Excluding code).

Most tools are downloaded from their GitHub releases into ~/.local/opt/<tool>-<version> and linked into ~/.local/bin. Old versions are removed afterwards, see Cleaning up old versions.

Required​

These cannot be excluded. The playbook stops at the start if software_tasks_exclude lists one of them.

NameInstalls
packagesUbuntu packages from default_apt_packages: tree, htop, jq, bat, gh, gdu, keychain, rsync, sqlite3, command-not-found, build tools and more. Tag: software_packages.
yqyq - YAML, JSON and XML processor. The playbook itself uses it.
zshoh-my-zsh plugins from omz_plugins and the powerlevel10k theme

Shell and terminal​

NameInstalls
tmuxtmux, built from source, with the tpm plugin manager
fzffzf - fuzzy finder
zoxidezoxide - jump to visited directories
ezaeza - modern ls, aliased as ls and ll, with zsh completion
ripgrepripgrep - fast recursive grep
fdfd - fast find alternative
fxfx - terminal JSON viewer
pay-respectspay-respects - corrects the previous command
bottombottom (btm) - system monitor
curliecurlie - curl frontend with HTTPie-style output; accepts all curl options
shellcheckShellCheck - static analysis for shell scripts (latest release, newer than the Ubuntu package)
w32yankwin32yank - Windows clipboard for Neovim on WSL

Git​

NameInstalls
gitLatest Git from the git-core PPA
lazygitlazygit - terminal UI for Git
diff-so-fancydiff-so-fancy - readable diffs
git-fuzzygit-fuzzy - Git commands in fzf
gitaGita - run commands on groups of repositories
lsgls-with-git-status - ls with Git status
hunkhunk - terminal code review and diff viewer, with the hunk-review skill for opencode
revdiffrevdiff - review diffs and plans with line annotations for AI agents, with its opencode plugin (/revdiff); sets untracked = true and word-diff = true in ~/.config/revdiff/config

Editor​

NameInstalls
neovimNeovim, as an AppImage or a tarball (neovim_package). The config is installed by the config role.

Languages and version managers​

NameInstalls
nvmNVM with the latest LTS Node (node_version) and the npm packages from npm_default_packages
gvmGVM with the Go versions from go_versions
rvmRVM (with rvm1-ansible) and the Rubies from rvm1_rubies (default ruby-3.4.7)
sdkmanSDKMAN! with Java, Gradle, Groovy and Maven (sdkman_install_packages)
rustRust with rustup and Cargo
uvuv - Python package and project manager
ansibleAnsible and ansible-lint (pip), and the Ansible Language Server (npm, needs nvm)
puppetpuppet and puppet-lint gems for the Rubies in puppet_rubies, PDK and Puppet Editor Services (needs rvm)

Python itself is installed by prepare-ubuntu.sh with pyenv and pyenv-virtualenv, not by this role.

Containers and Kubernetes​

NameInstalls
dockerDocker engine and the Compose plugin from Docker's APT repository (docker_apt_packages). With docker_manage_service: false and docker-ce: absent it installs only the client.
drydry - terminal UI for Docker
kubectlkubectl, latest stable from dl.k8s.io
kubecolorkubecolor - colorized kubectl (aliased as kubectl)
kubeswitchkubeswitch (switch) - switch contexts and namespaces
kindkind - local Kubernetes clusters in Docker
k9sk9s - terminal UI for Kubernetes
helmHelm - Kubernetes package manager
helm-unittesthelm-unittest - unit tests for Helm charts (helm unittest). A Helm plugin, so it needs helm. It is linked into helm_plugins_dir (default ~/.local/share/helm/plugins); a helm-unittest plugin installed there by other means is replaced.
kubeconformkubeconform - Kubernetes manifest validator
dyffdyff - YAML diff with Kubernetes-aware output
argocdArgo CD CLI with zsh completion
argonautArgonaut - terminal UI for Argo CD; uses the session saved by argocd login
sternstern - tail logs of many pods and containers at once, filtered by name regex or label
cranecrane - container registry CLI: list tags, copy images between registries, read digests and manifests without pulling

Infrastructure as code and cloud​

NameInstalls
tenvtenv - version manager for Terraform, OpenTofu and Terragrunt. Links its proxies (terraform, tofu, terragrunt, terramate, tf, atmos) into ~/.local/bin. The tasks below need it.
terraformTerraform, installed with tenv. The repository picks the version. See Terraform, OpenTofu and Terragrunt versions.
tofuOpenTofu, installed with tenv, like terraform
terragruntTerragrunt, installed with tenv, like terraform
tflintTFLint - Terraform linter; provider rulesets are set per project in .tflint.hcl
terraform-docsterraform-docs - generates the inputs and outputs documentation of a module
spacectlspacectl - Spacelift CLI: runs, logs, local previews
azurecliAzure CLI and kubelogin
az-account-switcheraz-account-switcher (az-switch)
awscliAWS CLI v2
grantedGranted (assume) - switch AWS profiles and SSO roles in the current shell, open the console for a role
session-manager-pluginSession Manager plugin - lets aws ssm start-session open shells and port forwards without SSH. Unpacked from AWS's .deb, no sudo.
tawstaws - terminal UI for AWS resources, in the style of k9s
eksctleksctl - CLI for Amazon EKS clusters, node groups, add-ons and IAM service accounts
eks-node-viewereks-node-viewer - live node usage against requests, with cost per node
steampipeSteampipe - SQL queries against cloud APIs. Plugins are not installed: run steampipe plugin install aws.

Terraform, OpenTofu and Terragrunt versions​

The repository decides the version. tenv's proxies look for it in this order, first match wins:

  1. an environment variable (TFENV_TERRAFORM_VERSION, TOFUENV_TOFU_VERSION, TG_VERSION)
  2. a version file in the directory or a parent: .terraform-version (or .tfswitchrc), .opentofu-version, .terragrunt-version, .tool-versions
  3. a version constraint in terragrunt.hcl or root.hcl
  4. the global default in ~/.tenv/<Terraform|OpenTofu|Terragrunt>/version, written by tenv tf use <version>
  5. the newest installed version that satisfies required_version

Proveasio installs the version from github_packages (latest by default) and does not write a global default: it would win over required_version. Outside a repository, the newest installed version runs. .zshrc sets TENV_AUTO_INSTALL=true, so a version a repository asks for is downloaded on first use. Proveasio never removes versions tenv installed; use tenv tf uninstall <version>.

Before tenv, Proveasio unpacked these tools into ~/.local/opt/<tool>-<version>. The first run with tenv deletes those directories and points ~/.local/bin/terraform, tofu and terragrunt at tenv's proxies. Pins in github_packages keep working.

Excluding tofu or terragrunt skips installing a version, but tenv's proxy for it stays on the PATH. With TENV_AUTO_INSTALL, calling it installs a version.

AI coding agents​

NameInstalls
opencodeopencode - terminal AI coding agent. Installs v2 by default; pin a 1.x version to keep v1 (see opencode v1 and v2). Can also install with a preinstalled Homebrew (opencode_package: brew, see Install opencode with Homebrew).
ccmuxccmux - run and track AI coding agents (opencode, Claude Code, Codex and more) in tmux, with live session states, a sidebar and desktop notifications
wsl-notify-sendwsl-notify-send - bridges ccmux notifications to Windows toasts on WSL

Bundles​

A bundle groups the tools for one purpose. Its name works as a tag (--tags terraform-tools) and as an exclude name (software_tasks_exclude: [terraform-tools]). You can still leave out single tools of a selected bundle:

ansible-playbook -i inventory.yml setup-ubuntu.yml --tags terraform-tools --skip-tags tofu -K
# ansible/vars/overrides.yml: everything AWS, except taws
software_tasks_exclude:
- azure-tools
- taws
BundleTools
aws-toolsawscli, granted, session-manager-plugin, taws, eksctl, eks-node-viewer, steampipe
azure-toolsazurecli, az-account-switcher
kubernetes-toolskubectl, kubecolor, kubeswitch, k9s, helm, helm-unittest, kubeconform, dyff, kind, stern, crane
terraform-toolstenv, terraform, tofu, terragrunt, tflint, terraform-docs
argocd-toolsargocd, argonaut
spacelift-toolsspacectl

Bundles are defined in software_bundles in ansible/roles/software/vars/main.yml. Each member's include in tasks/main.yml carries the bundle tag; the playbook stops at the start if a member is not an include name.

Dependencies​

What a tool needs, and what it installs besides itself. A tool listed under "Needs" must be installed too, by the same run or an earlier one.

ToolNeedsAlso installs
every GitHub toolpackages (curl, jq, unzip), yq (version receipt)
zshpackagesoh-my-zsh plugins, powerlevel10k
ansiblePython (prepare-ubuntu.sh), nvmansible-lint, Ansible Language Server (npm)
neovim confignvm, gvm, rvmlanguage servers and tools through Mason (npm, go and gem packages)
puppetrvmpuppet, puppet-lint, PDK, Puppet Editor Services
helm-unittesthelm
azureclikubelogin
terraform, tofu, terragrunttenv
tenvproxies: terraform, tofu, terragrunt, terramate, tf, atmos
grantedassume, assumego
argonautargocd login (argocd login)
session-manager-pluginawscli to be useful
ccmuxtmux
wsl-notify-sendWSL

Configuration​

Everything this role can configure is in ansible/roles/software/vars/main.yml. Override it in ansible/vars/overrides.yml, see Customizations. For example, to skip some tools:

software_tasks_exclude:
- azurecli
- puppet