Version: develop

Installation

Docker

To build Proveasio as a Docker image instead of installing it on your machine, see Docker image.

Assuming all the requirements are met:

Launch Ubuntu terminal (if using WSL - ensure it is running with systemd, see manual setup)
Download the project - see Download
Go to downloaded directory: cd ~/proveasio
Create file ansible/vars/overrides.yml - set desired GIT config name and e-mail. See ansible/vars/README.md for more examples
```
git:
  name: James
  mail: james.doe@hell.no
```
Run sudo ~/proveasio/prepare-ubuntu.sh (if not already run during windows setup) to update the system and install required python and ansible packages
Reload your terminal (close and open again)
Run ansible:
```
cd ~/proveasio/ansible; ansible-playbook -i inventory.yml setup-ubuntu.yml -K
```
Ubuntu 25.10 and newer
These releases use sudo-rs as sudo, and 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.
After successful installation (green summary of versions installed), reload you terminal.

note

If either the preparation or installation steps are failing for you (#4 or #6), please see Troubleshooting section. If there is no answer for your problem, please create an Issue in Github.