selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Olares logo

Self-host Olares

1.12.7

Personal cloud OS that runs AI agents on your own hardware

ReleaseOpen SourceAGPL-3.0
curl -fsSL https://olares.sh | bash -
Updatedlast month
LanguageGo
Setup difficultyAdvanced
Stars
5 358
CPU
At least 4 cores
RAM
At least 8 GB of available memory
Storage
At least 150 GB of available SSD storage; installation will fail on an HDD
Ports
80, 443, 30180, 18088, 41641
Docker
beclab/olares
Olares desktop login page in a browserThe Olares setup wizard welcome page opened in a browser

What is Olares?

Should you self-host Olares?

Olares scores 65/100 on selfhost.directory (how scoring works) and ranks #4 of 22 in Home Server. It has 5 358 GitHub stars, +53 in the last 30 days.

It shipped 148 stable releases in the past year. The latest, 1.12.9-20261111, came out on 11 November 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is CasaOS (78/100, 37 632 stars). It scores higher overall, so compare the two before you pick. See Olares vs CasaOS side by side.

Features

  • Application sandboxing
  • Backup and Restore
  • Browser-based desktop access
  • Built-in system apps
  • Command-line management
  • File Management
  • GPU pooling and sharing
  • Local AI agent and LLM hosting
  • Local speech and generative media
  • Media streaming and smart home
  • Multi-node cluster
  • Multi-user access with roles
  • Natural-language operation
  • One-click app and model marketplace
  • Private networking with VPN and reverse proxy

Olares README

Olares

Your AI Agent. Your Data. Your Hardware.

Install Olares · Manage Olares with AI · Contribute

GitHub release (latest by date) GitHub Repo stars Discord License

beclab%2FOlares | Trendshift

Readme in English Readme in Chinese Readme in Japanese

Olares is an open-source personal cloud OS you operate in plain language, built to run AI agents and LLMs on hardware you own.

Powered by Kubernetes, it turns your machines into a self-hosted AI platform accessible from any browser, giving everyone from individual users to small teams a unified place for compute, storage, networking, and apps.

How to install Olares

Install Olares with Docker Compose

Docker and Docker Compose installed and running
Environment variables
VERSION, OLARES_HOST_IP
services:
  olares:
    image: beclab/olares:${VERSION}
    privileged: true
    volumes:
      - oic-data:/var
    ports:
      - "80:80"    
      - "443:443"    
      - "30180:30180"    
      - "18088:18088"    
      - "41641:41641/udp"
    environment:
      - OLARES_HOST_IP=${HOST_IP}

  olaresd-proxy:
    image: beclab/olaresd:proxy-v0.1.0
    network_mode: host
    depends_on:
      olares:
        condition: service_started

volumes:
  oic-data:
VERSION=<olares version> OLARES_HOST_IP=<host ip> docker compose up -d

Containerized installation on Linux; GPU variant adds an nvidia device reservation under deploy.resources.reservations.devices.

How to configure Olares

  • OLARES_HOST_IPSpecifies the Linux machine's IP address when installing with Docker Compose.

    values: Host IP address

  • KUBE_TYPEk3sDetermines the Kubernetes distribution to install.

    values: k8s, k3s

  • CLOUDFLARE_ENABLE0Specifies whether to enable the Cloudflare proxy.

    values: 0 (disable), 1 (enable)

  • FRP_AUTH_METHODjwsSets the FRP authentication method.

    values: jws, token (requires FRP_AUTH_TOKEN), empty for no authentication

  • FRP_AUTH_TOKENSpecifies the token for FRP communication (required if FRP_AUTH_METHOD=token).

    values: Any non-empty string

Olares releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Does the system support multi-user environments?

Yes, sub-accounts exist with Super Admin, Admin and Member roles, so a team can share files and one installed AI model on a single cluster.

Does Olares collect my data?

No: storage, computation and AI processing run on your own hardware, and private data is not sent to a centralized service.

Is it possible to build Olares from source code?

Yes, but it is currently complex because the project spans more than 90 repositories and has no fully integrated local build system.

Is Olares open source?

Yes; Olares and LarePass are AGPL-3.0, the Olares ID smart-contract protocols use Apache 2.0, and third-party Market apps keep their own licenses.

How often does Olares update?

A major release comes out roughly every two months.

Do I need to pay for Olares?

No, Olares OS is free and open source for self-hosting; only Olares One hardware is a purchase, and the optional Olares Space cloud backup and FRP relay both have free alternatives.

Can I use my own domain name?

Yes, you can replace the default olares.com domain with your own custom domain, though that setup currently goes through LarePass.

Can I use Olares without the LarePass app?

Partly: olares-cli can activate a device from the terminal, but you still need LarePass to create the Olares ID, and standalone deployment of components is planned.

What is LarePass and why is it required?

LarePass is the official Olares client, acting as a secure bridge for access and cross-device file sync; activating a device currently requires it.

Is internet access required to use Olares?

Day-to-day use is local-first, but initial activation currently needs internet; you can restrict access to VPN only or use .local domains.

Why is an Olares ID required?

It automates secure remote access: the system registers a subdomain, configures the reverse proxy and manages HTTPS certificates for you. The project plans to make it optional.

How is Olares different from NAS operating systems?

Olares is aimed at being a personal AI cloud rather than a storage appliance, with native GPU resource orchestration and strict per-app isolation.

Who is Olares for?

People who want strong AI tools running locally without heavy technical setup; general users install apps such as ComfyUI or Vane in one click, and developers use it as a local build and test environment.

What is a "personal cloud"?

Private infrastructure on your own hardware that reproduces what public clouds give you, such as access to files and computing power from anywhere.

What is Olares?

An open-source personal cloud operating system built on Kubernetes that lets you own and run your digital assets and services on your own hardware.

More in Home Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…