Install Olares on PVE with ISO image

You can install Olares directly on Proxmox Virtual Environment (PVE) using an ISO image. This guide walks you through downloading the Olares ISO, configuring PVE environment, completing the installation, and getting your Olares up and running.

Not recommended for production use

Currently, Olares on PVE has certain limitations. We recommend using it only for development or testing purposes.

Having trouble with installation?

If you encounter issues during the installation process, feel free to submit a GitHub Issue. Please include the following information when submitting:

• The platform or environment you're using (e.g., Ubuntu, PVE, etc.).
• The installation method (script installation or ISO image).
• Detailed error information (including logs, error messages, or screenshots).

System requirements

Make sure your device meets the following requirements.

• CPU: At least 4 cores
• RAM: At least 8GB of available memory
• Storage: At least 200GB of available SSD storage. The installation will likely fail if an HDD (mechanical hard drive) is used instead of an SSD.
• Supported Systems: PVE 8.2.2

Download Olares ISO image

Click here to download the official Olares ISO image.

Configure VM in PVE

To run Olares on PVE, make sure the VM is configured with the following settings. You can either apply them when creating a new VM or adjust an existing VM to match these requirements.

• OS:
  • ISO image: Select the official Olares ISO image you just downloaded.
• System:
  • BIOS: Select OVMF (UEFI).
  • EFI Storage: Choose a storage location (for example, a local LVM or directory) to store UEFI firmware variables.
  • Pre-Enroll keys: Uncheck the option to disable Secure Boot.
• Disks:
  • Disk size (GiB): At least 200GB.
• CPU:
  • Cores: At least 4 cores
• Memory:
  • Memory (MiB): At least 8GB

Below is a sample configuration for the VM hardware settings in PVE.

Version compatibility

While the specific version is confirmed to work, the process may still work on other versions. Adjustments may be necessary depending on your environment. If you meet any issues with these platforms, feel free to raise an issue on GitHub.

Install on PVE

Once the VM is set up, follow these steps to install the ISO on PVE.

1. Start the virtual machine (VM).

2. From the boot menu, select Install Olares to Hard Disk.

3. In the Olares System Installer, a list of available disks will appear (for example, sda 200G QEMU HARDDISK). Select the first disk by typing /dev/ plus its name (for example, /dev/sda). When the on-screen warning appears, just type yes to continue.

   Note

   During installation, warnings related to the NVIDIA graphics driver may appear. If they do, press Enter to ignore them.

4. Once the installation completes, you’ll see the message:

   Installation completed successfully!

   Press Enter, then click Reboot in the Proxmox web interface to restart the VM.

Verify installation

After the VM restarts, it will boot into the Ubuntu system.

1. Log in to the Ubuntu using the default credentials:

   • Username: olares
   • Password: olares

2. Confirm that Olares has been installed successfully using the following command:

   sudo olares-check

   The installation is successful if you see results like:

   ...
   check Olaresd:  success
   check Containerd:  success

Activate Olares

To activate Olares:

1. Open LarePass app.

2. Tap Discover nearby Olares. Your Olares device should appear.

3. Tap Install now to finish the installation process.

4. Tap Activate now to activate Olares and complete initialization.

5. Follow the prompt to set the login password for Olares.

   

Once complete, you can access Olares via the provided URL and your credentials.

Same network required

Make sure your phone and the PVE host are on the same network.

Log in to Olares

1. Enter your URL (https://desktop.{olares-id}.olares.com) in your browser, and press any key to continue.

2. On the login page, enter your Olares login password.

   

3. You will be prompted to complete two-factor verification. You can confirm the login on LarePass, or manually enter the 6-digit verification code.

   

   INFO

   The verification code is time-sensitive. Ensure you enter it before it expires. If it does, you will need to generate a new code.

Once you've logged in, you'll be directed to the Olares desktop.🎉

Next step: Protect your Olares ID

You're almost ready to start using Olares! Before diving in, it's crucial to ensure your Olares ID is securely backed up. Without this step, you won't be able to recover Olares ID if needed.

• Back up your mnemonic phrase