2025-06-13 14:48:47 +08:00

1.6 KiB

Ansible Playbook for LXC/Incus Installation (Debian/Ubuntu)

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 & Git: Must be installed on the machine where you are running the playbook.
    sudo apt update
    sudo apt install ansible git -y
    
  2. Sudo Access: Your user must have sudo privileges to run the playbook.

How to Run

  1. Setup: Clone the repository and go to the project directory

    git clone https://git.marmattheo.com/marmattheo/LXC-Incus-stable-playbook.git && cd incus-stable-playbook
    
  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. Configure User Access:

    Refresh group membership.

    newgrp incus-admin
    
  2. Verify Setup:

    You can test the installation by running.

    incus --version
    
  3. Access the Incus Web UI:

    Access the Web UI at:

    https://localhost:8443
    

    https://vps-ip:8443 if you're running on remote server

    Follow the self-signed certificate instructions when prompted for mLTS