Installation
To build Proveasio as a Docker image instead of installing it on your machine, see Docker image.
Make sure the requirements are met, then:
-
Open an Ubuntu terminal. On WSL, check that it runs with
systemd(see manual setup). -
Download the project, see Download.
-
Go to the project directory:
cd ~/proveasio -
Create
ansible/vars/overrides.ymland set your git name and e-mail. More examples are inansible/vars/README.md.git:name: Jamesmail: james.doe@hell.no -
Run
sudo ~/proveasio/prepare-ubuntu.sh, unless you already ran it during the Windows setup. It updates the system and installs Python (with pyenv) and Ansible. -
Close the terminal and open it again, so the new Python and Ansible are on your
PATH. -
Log in to GitHub, so the version lookups do not hit the API rate limit (optional, but recommended):
gh auth login # or: export GITHUB_TOKEN=<token>ghis installed by the playbook. On the first run, useGITHUB_TOKEN. See GitHub API rate limits. -
Run the playbook. Run it from the
ansible/directory, because Ansible readsansible.cfgfrom the current directory only.-Kasks for your sudo password and is required:cd ~/proveasio/ansibleansible-playbook -i inventory.yml setup-ubuntu.yml -K -
When the run ends with the green summary of installed versions, close the terminal and open it again.
To update everything later, pull the repository and run step 8 again. See Download.
sudo-rs
Ubuntu 26.04 uses sudo-rs as sudo. Ansible does not recognize its password prompt, so -K fails even with the correct password. Proveasio uses the classic sudo (/usr/bin/sudo.ws) when it is installed. If it is missing, install it with sudo apt install sudo.
If the preparation or the playbook fails (steps 5 or 8), see Troubleshooting. If it does not cover your problem, open an issue on GitHub.