Install Olares
Olares is open source and can be installed on hardware you already own. For self-hosting, you can start with a clean machine, install on an existing Linux system, or use Docker Compose. Olares One and NVIDIA DGX Spark provide device-specific setup options.
Choose the section that matches your device:
- Your own device: Install Olares on Linux.
- Olares One: Set up or reinstall Olares One.
- NVIDIA DGX Spark: Install Olares on DGX Spark.
Linux
Use the following methods to install Olares on your own compatible hardware. Linux is recommended for production deployments.
System requirements
SSD required
Installation on an HDD will fail.
| Item | Requirement |
|---|---|
| CPU | 4 cores or more |
| Memory | 8 GB or more |
| Storage | 150 GB or more on an SSD |
Optional GPU
A GPU is not required to install Olares, but most AI apps need one. Only NVIDIA GPUs are supported.
| Item | Requirement |
|---|---|
| Architecture | Turing or newer, including GTX 16xx and RTX 20xx, 30xx, 40xx, and 50xx series |
| VRAM | 8 GB or more recommended |
Not sure if your GPU is supported?
Run the following command and check the code name prefix in the output:
lspci | grep -i nvidiaExample output:
3b:00.0 VGA compatible controller: NVIDIA Corporation AD102 [GeForce RTX 4090] (rev a1)The code name prefix maps to GPU architecture as follows:
| Code name prefix | Architecture | Supported |
|---|---|---|
| GB | Blackwell | ✓ |
| AD | Ada Lovelace | ✓ |
| GA | Ampere | ✓ |
| TU | Turing | ✓ |
| GP | Pascal | ✗ |
| GM | Maxwell | ✗ |
You can also verify against the full compatible GPU list from the NVIDIA open driver repository.
Installation methods
| Method | Best for |
|---|---|
| ISO image (Recommended) | A fresh installation on a physical machine with an Intel or AMD x86-64 processor |
| One-line script | An existing Ubuntu 22.04–25.04 or Debian 12/13 system |
| Docker Compose | A containerized installation on Ubuntu 22.04–25.04 or Debian 12/13 |
Olares One
Olares One has dedicated setup and recovery workflows that preserve its hardware-specific features.
Use the Olares One setup guides
Do not install Olares One using the generic Linux ISO image or one-line script. The device may be recognized as generic hardware, and some Olares One features may be unavailable.
| Task | Recommended guide |
|---|---|
| Set up a new Olares One | First boot |
| Reinstall or recover Olares OS | Olares One ISO |
DGX Spark
NVIDIA DGX Spark is a compact AI development platform featuring a high-performance GPU. Olares is optimized to leverage the full capabilities of DGX Spark hardware.
Installation methods
| Method | Best for |
|---|---|
| One-line script (Recommended) | Installing from the existing DGX OS with at least 150 GB of available SSD storage |
| ISO image | A fresh installation from a bootable USB drive |