Install Olares

This page provides an overview of supported installation methods for Olares.

Before installation, make sure you have:

• Created your Olares ID.
• Verified your operating system and hardware meet the minimum requirements as described in the specific guide.

Choosing the right method

Olares supports multiple platforms and deployment methods. Choose the installation method that best fits your environment.

Recommended for production

Linux (Ubuntu or Debian) is the recommended platform for running Olares, as it offers the best performance and stability in production environments.

• ISO image: Perform a fresh installation on a physical machine, auto
  configuring the Linux host environment, container runtime,
  drivers, and core dependencies.
• One-line script: Quick install on existing Linux systems.

Recommendation

The ISO installation method ensures maximum compatibility, performance, and system-level optimization.

Alternative installation methods

These methods are suitable for development, testing, or lightweight environments.

Windows

• One-line script: Install Olares in Windows Subsystem for Linux 2 (WSL 2).
• Docker image: Run Olares in Docker with WSL 2 integration.

macOS

• One-line script: Install Olares in a containerized environment via MiniKube.
• Docker image: Run Olares in Docker on macOS.

PVE

• ISO image (recommended): Deploy Olares as a full VM in Proxmox VE using the ISO installer.
• One-line script: Install Olares directly on a PVE node.
• LXC container: Deploy Olares in Proxmox VE using Linux containers (LXC).

Raspberry Pi (ARM)

• One-line script: Install Olares on ARM-based Raspberry Pi devices.