From f114d214ba0fe849e4a89a8962ea2bb7bce964d9 Mon Sep 17 00:00:00 2001 From: marito Date: Tue, 10 Jun 2025 15:34:15 +0800 Subject: [PATCH] readme update --- README.md | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 46ae431..c8b11fa 100644 --- a/README.md +++ b/README.md @@ -9,15 +9,11 @@ This playbook automates the installation and setup of the **stable** version of 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: - ```bash - ansible-galaxy collection install community.general - ``` -3. **Sudo Access:** Your user must have `sudo` privileges to run the playbook. +2. **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. +1. **Customize Variables (Optional):** Open `playbook.yml` and review the `vars` section. 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. @@ -31,8 +27,23 @@ This playbook automates the installation and setup of the **stable** version of 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`. +1. **Configure User Access:** + Add your user to incus-admin group -2. **Access the Web UI:** Open a browser and navigate to `https://localhost:8443`. You will need to accept the self-signed certificate. + ```bash + sudo usermod -aG incus-admin $USER + ``` + To refresh group membership. -3. **Verify Setup:** You can test the installation by running `incus list`. If it runs without `sudo`, the setup is successful. + ```bash + newgrp incus-admin + ``` + +2. **Initialize Incus:** + Run the interactive initialization and follow the prompts to configure storage pools, networks, and other settings. + + ```bash + incus admin init + ``` + +3. **Verify Setup:** You can test the installation by running `incus list`.