Installation Options

Multiple ways to run OROBOROS OS

Live USB Recommended

Boot directly from a USB drive without modifying your existing system. Perfect for trying OROBOROS OS or running it as a portable environment.

  1. Download the Live USB image (ISO file)
  2. Flash the image to a USB drive (32GB+ recommended) using balenaEtcher or Rufus
  3. Restart your computer and boot from the USB drive
  4. Select "Start OROBOROS OS" from the boot menu
  5. Begin using OROBOROS OS immediately
Download USB Image

Docker Container

Run OROBOROS OS as a Docker container. Ideal for server deployments, testing, or integrating with existing containerized environments.

  1. Ensure Docker is installed on your system
  2. Pull the OROBOROS OS image:
    docker pull oroboroslab/oroboros-os:v1.0
  3. Run the container:
    docker run -it -p 8080:8080 oroboroslab/oroboros-os:v1.0
  4. Open your browser to http://localhost:8080
View on Docker Hub

Virtual Machine

Run OROBOROS OS in a virtual machine. Great for isolated testing, development environments, or running alongside your main OS.

  1. Download the VM image (OVA format)
  2. Open VirtualBox, VMware, or your preferred hypervisor
  3. Import the OVA file (File > Import Appliance)
  4. Allocate at least 8GB RAM and 4 CPU cores
  5. Start the virtual machine
Download VM Image

Docker Compose

Full stack deployment with all services configured. Best for production deployments or when you need the complete OROBOROS OS environment.

  1. Download the docker-compose.yml file
  2. Create a directory for OROBOROS OS data
  3. Run: docker-compose up -d
  4. Access at http://localhost:8080
  5. View logs: docker-compose logs -f
Download Compose File

System Requirements

What you need to run OROBOROS OS

Minimum Requirements

Basic operation with smaller AI models and essential features.

Component Requirement
Processor 64-bit CPU, 4 cores minimum
Memory 8 GB RAM
Storage 50 GB available space (SSD recommended)
USB (for Live USB) 32 GB USB 3.0 drive
Operating System Windows 10+, macOS 12+, or Linux kernel 5.4+

Recommended Requirements

Optimal performance with larger models and full AI capabilities.

Component Requirement
Processor 64-bit CPU, 8+ cores
Memory 16-32 GB RAM
Storage 200 GB SSD (NVMe preferred)
Graphics NVIDIA RTX 3060+ (8GB+ VRAM) for GPU acceleration
USB (for Live USB) 64+ GB USB 3.1/3.2 drive

GPU Support Notes

Downloads

Get the version you need

ISO

Live USB Image

Bootable ISO image for creating a Live USB installation. Works with balenaEtcher, Rufus, or dd.

Size: ~8 GB

Version: 1.0.0 Public Release

Download ISO
OVA

VM Image

Pre-configured virtual machine image. Compatible with VirtualBox, VMware, and other hypervisors.

Size: ~12 GB

Version: 1.0.0 Public Release

Download OVA
TAR

Source Package

Complete source code and build scripts for custom installations and development.

Size: ~500 MB

Version: 1.0.0 Public Release

Download Source

Quick Start Guide

Get up and running in minutes

First Boot Setup

When you first start OROBOROS OS, the setup wizard will guide you through initial configuration:

  • Language & Region: Select your preferred language and timezone.
  • AI Model Selection: Choose which AI models to download. Start with smaller models if space is limited.
  • Privacy Settings: Configure your privacy preferences. All options default to maximum privacy.
  • System Check: Automatic hardware detection to optimize AI performance for your system.
  • Ready to Use: After setup, you're ready to start using OROBOROS OS.

First Steps

  • Open the AI Chat application to start interacting with your assistant
  • Use Model Manager to download additional AI models
  • Check System Settings to customize your experience
  • Visit the Documentation for in-depth guides
START

Troubleshooting

Common issues and solutions

USB Won't Boot

Ensure Secure Boot is disabled in BIOS/UEFI settings. Try a different USB port (preferably USB 3.0). Verify the ISO was written correctly using the verification checksum.

Slow AI Performance

Check if GPU is detected in System Settings. Try smaller AI models if RAM is limited. Ensure no other applications are using GPU resources.

Docker Connection Failed

Verify Docker daemon is running. Check if port 8080 is available. Try running with elevated privileges if permission errors occur.

VM Performance Issues

Allocate more RAM to the VM (16GB+ recommended). Enable VT-x/AMD-V virtualization in BIOS. Use SSD storage for the VM disk.

Need Help?

Join our community for support and discussions.

Join Discord Read Documentation