Ansible Playbook for Local Incus Installation

This playbook automates the installation and setup of the stable version of Incus on the local machine (Debian/Ubuntu). It is designed to be run directly on the server you wish to configure.

Prerequisites

1. Ansible: Must be installed on the machine where you are running the playbook.

   sudo apt update
   sudo apt install ansible -y
   

2. UFW Ansible Collection: The playbook uses the community.general.ufw module. Install it if you don't have it:

   ansible-galaxy collection install community.general
   

3. Sudo Access: Your user must have sudo privileges to run the playbook.

How to Run

1. Customize Variables (Optional): Open playbook.yml and review the vars section. You can change the storage pool driver, network settings, etc. The defaults are sensible for a standard ZFS-based setup.

2. Execute the Playbook: Run the following command from the same directory as the playbook file. It will prompt you for your sudo password to perform the administrative tasks.

   ansible-playbook playbook.yml --ask-become-pass
   

   • --ask-become-pass: This flag tells Ansible to prompt for the password needed for privilege escalation (sudo).

Post-Installation Steps

After the playbook completes successfully:

1. Log Out and Log Back In: To apply the incus-admin group membership to your user session, you must log out and log back in. Alternatively, for the current session only, you can run newgrp incus-admin.

2. Access the Web UI: Open a browser and navigate to https://localhost:8443. You will need to accept the self-signed certificate.

3. Verify Setup: You can test the installation by running incus list. If it runs without sudo, the setup is successful.