From d96220d5b940f49dd5e22133c763b85bad91d5a0 Mon Sep 17 00:00:00 2001
From: Ahmed Abdelhalim <pm@a14m.dev>
Date: Mon, 11 Aug 2025 00:33:31 +0200
Subject: Update README with detailed instructions

---
 ubuntu.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 ubuntu.md

(limited to 'ubuntu.md')

diff --git a/ubuntu.md b/ubuntu.md
new file mode 100644
index 0000000..646a2fa
--- /dev/null
+++ b/ubuntu.md
@@ -0,0 +1,24 @@
+# Install Ubuntu
+
+- Download [ubuntu](https://ubuntu.com/download/alternative-downloads)
+- Format a USB
+- Unmount disk (on MacOS ex. `diskutil unmountDisk /dev/diskX`)
+- Create bootable image from iso `sudo dd if=/path/to/image.iso of=/dev/diskX bs=4M status=progress`
+- Boot the `ubuntu` live image from a bootable USB
+- Connect to wireless network (if not connected via LAN)
+- Set root password (which will be asked to run the install playbook)
+- Set the hostname to `ubuntuiso.local`
+- Install and configure ssh
+- `cp host_vars/ubuntuiso.local.example host_vars/ubuntuiso.local`
+- Update the `host_vars/ubuntuiso.local` file
+- Run the playbook on the ansible controller
+
+**Example:**
+
+```bash
+nmcli dev wifi connect <SSID> password <PASSPHRASE>
+sudo hostnamectl set-hostname ubuntuiso.local
+sudo apt update
+sudo DEBIAN_FRONTEND=noninteractive apt install -y openssh-server
+sudo systemctl restart ssh avahi-daemon
+```
-- 
cgit v1.2.3