====== Ubuntu 24.04 Installation & Setup ======
{{:qortal_official_logo_transparent_.png?400|}}

Hello Qortians! This guide is for installation of Ubuntu 24.04 with automated configuration via crowetic's script to setup everything necessary for Qortal, and automate as much as possible.

**Please note:** IF YOU ARE GOING TO BE INSTALLING UBUNTU ON THE CURRENT COMPUTER YOU'RE USING, YOU WILL NEED TO SKIP THE BIOS CONFIGURATION UNTIL AFTER YOU HAVE DOWNLOADED THE UBUNTU 24.04 INSTALLATION MEDIA, AND BURNED IT TO A FLASH DRIVE. YOU WILL ALSO WANT TO BACKUP YOUR PERSONAL FILES, QORTAL WALLET BACKUP, DOCUMENTS, PICTURES, AND ANYTHING ELSE YOU NEED FROM YOUR COMPUTER TO ANOTHER HARD DRIVE. IDEALLY YOU WILL HAVE AN EXTERNAL HDD TO BACKUP FILES, AND A FLASH DRIVE FOR WRITING THE UBUNTU INSTALLATION MEDIA. WE DO NOT TAKE RESPONSIBILITY FOR ANYONE FOLLOWING THIS GUIDE AND NOT READING THOROUGHLY, AND LOSING PERSONAL DATA OR THEIR QORTAL BACKUP FILE. MAKE SURE YOU BACKUP THINGS FIRST!

This guide focuses on a **clean base installation**, with **full system configuration handled automatically** by the setup script.

===== Configuring The BIOS =====

Any good base-level setup guide includes starting at the lowest possible level. In our case, this means starting **in the BIOS**.

**All BIOS are different**, but the important points remain consistent:

===== Disabling Nonsense =====

Disable unnecessary features where possible:
- Intel Management Engine
- Computrace
- TPM (optional depending on use case)

===== Disabling Secure Boot =====

(Optional)

Secure Boot is not required for Ubuntu. Disabling it avoids additional configuration complexity.

===== UEFI vs Legacy Boot =====

Prefer **UEFI mode** for:
- Firmware update support
- Modern compatibility

If available, enable **CSM (Compatibility Support Module)** for flexibility.

===== Other Recommended BIOS Settings =====

- Enable virtualization features
- Enable HyperThreading / TurboBoost
- Use adaptive battery settings (if applicable)

===== Installing Ubuntu 24.04 =====

**Download Ubuntu 24.04 Desktop ISO**  
https://ubuntu.com/download/desktop

===== Creating Installation Media =====

Before installing Ubuntu, you must create a **bootable USB flash drive**.

You will need:
- Ubuntu 24.04 ISO
- USB flash drive (8GB+ recommended)

**Download Ubuntu 24.04 Desktop ISO**  
https://ubuntu.com/download/desktop

===== Windows =====

Use Rufus:

https://rufus.ie/en/

- Insert USB drive
- Open Rufus
- Select downloaded Ubuntu ISO
- Use default settings (UEFI recommended)
- Click **Start**

===== Linux =====

Use `dd` (WARNING: destructive if misused):

<code>
lsblk
sudo dd if=ubuntu-24.04-desktop-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync
</code>

Replace `/dev/sdX` with your USB device.

===== macOS =====

Use `dd` or:

https://www.balena.io/etcher/

===== Booting from USB =====

- Insert USB into target machine
- Reboot system
- Enter boot menu (commonly F12, ESC, DEL)
- Select USB device (UEFI mode preferred)

You will then see:
**Try or Install Ubuntu**

Select **Install Ubuntu** to proceed.

===== Installation Notes =====

- Connect to network (LAN or WiFi)
- Enable "Download updates during installation"
- Use username **qortal** (recommended for automation compatibility)

Disk setup:
- Choose **Erase Disk and Install Ubuntu** for a clean install

After installation:
- Reboot and remove installation media
- Ensure system boots correctly (adjust UEFI boot order if needed)

===== Installing Software & System Configuration =====

**Congratulations! Ubuntu is now installed.**

At this stage, **DO NOT manually configure the desktop environment, themes, or applications.**

All system setup is now handled automatically by the script below.

===== Crowe's 'rebuilt-machine.sh' Script =====

This script now performs **full system provisioning**, including:

- Desktop environment installation and configuration
- Theme, layout, and UI customization
- Qortal Core installation
- Qortal Hub installation
- Automation scripts (auto-fix, monitoring, cron setup)
- Required dependencies and applications

**Download and run the script:**

<code>
cd && wget https://raw.githubusercontent.com/crowetic/QORTector-scripts/main/rebuilt-machine.sh && chmod +x rebuilt-machine.sh && ./rebuilt-machine.sh
</code>

Enter your user password when prompted.

The script will:
- Install all required packages
- Configure the entire desktop environment automatically
- Install and configure Qortal Core + Hub
- Set up automation and background services

**Once complete, the system will reboot automatically.**

===== Important Notes =====

- Manual desktop configuration is no longer required
- Manual theme setup is no longer required
- Manual launcher/menu configuration is no longer required

Everything is handled by the script for consistency and reliability.

===== Ubuntu Power Settings =====

To ensure Qortal runs continuously:

- Open Power Settings
- Set **Suspend when inactive** → **Never**
- Set **Lid close action** → **Do Nothing**
- Set **Power button** → **Ask**

Apply for both:
- Plugged in
- Battery (if applicable)

===== Qortal Startup Behavior =====

Startup configuration is handled automatically by the script.

No manual startup configuration is required.

===== Additional Notes =====

No manual configuration is required after running the setup script.

All automation, paths, and user-specific configuration are handled dynamically by the script.

===== Summary =====

This setup now prioritizes:

- **Minimal manual configuration**
- **Full automation via script**
- **User-agnostic deployment (no required username)**
- **Consistent, reproducible environments**
- **Reliable Qortal node operation**