explaingit

beclab/olares

4,533GoAudience · ops devopsComplexity · 4/5LicenseSetup · hard

TLDR

An open-source personal cloud operating system you install on your own hardware to privately host files, AI models, apps, and media, without relying on Google, Apple, or any big-tech cloud service.

Mindmap

mindmap
  root((olares))
    What it does
      Personal cloud OS
      App hosting
      Local AI models
      Remote access
    Tech stack
      Go
      Kubernetes
      Tailscale
      Ollama
    Built-in apps
      File manager
      Password vault
      Media server
      AI tools
    Use cases
      Self-hosted cloud
      Private AI
      Home server hub
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Replace cloud storage by hosting your own file sync and sharing on hardware you physically control at home.

USE CASE 2

Run open-source AI models like Llama locally through Ollama so your private data never leaves your machine.

USE CASE 3

Self-host a media server, blog (Ghost), or social platform (Mastodon) through the Olares app market on your home server.

USE CASE 4

Manage all your self-hosted apps under one login with built-in single sign-on and secure remote access via Tailscale.

Tech stack

GoKubernetesTailscaleOllamaComfyUI

Getting it running

Difficulty · hard Time to first run · 1h+

Requires Ubuntu 24.04 LTS or Debian 11 or later on your own hardware, plus Tailscale or Cloudflare Tunnel configuration for remote access.

Free to use and modify, but any modified version you distribute must also be open-source under AGPL-3.0.

In plain English

Olares is an open-source personal cloud operating system you install on your own hardware. The idea is that instead of storing your photos, files, messages, and AI interactions on servers run by large technology companies, you host everything at home on a device you control. The project draws a parallel to public cloud infrastructure, where companies offer storage, apps, and services, and delivers those same capabilities locally with you in full ownership. On the practical side, Olares ships with a built-in suite of applications: a file manager, password vault, media reader, app market, dashboard, and settings panel. It supports running open-source AI tools locally, including large language models via Ollama, image generation via ComfyUI, and a private AI search tool. For remote access, it integrates with networking tools like Tailscale and Cloudflare Tunnel so you can reach your home setup securely from anywhere without complex configuration. The system includes a shared single sign-on layer, so one login covers all installed applications. Apps run in sandboxed environments for isolation. The underlying infrastructure handles automated backups, scaling, and high availability for files and databases. A web-based control panel lets you manage the system and its apps. Highlighted use cases from the project include running AI models against your own private data, syncing files across devices, hosting a personal media streaming server, self-hosting decentralized social media tools like Mastodon or Ghost, managing smart home devices from a central hub, and building a collaborative workspace for a small team using open-source software. Installation is tested on Ubuntu 24.04 LTS or later and Debian 11 or later, and a step-by-step getting-started guide is available in the project documentation. The license is AGPL-3.0.

Copy-paste prompts

Prompt 1
Walk me through installing Olares on Ubuntu 24.04 on a home server, including the Tailscale networking setup for secure remote access.
Prompt 2
How do I install and run Ollama through Olares to chat with a local LLM using my own private documents?
Prompt 3
What are the minimum hardware requirements for running Olares with local AI workloads, and which apps come pre-installed?
Prompt 4
How do I set up Cloudflare Tunnel in Olares so I can access my home server securely from outside my home network?
Prompt 5
How does Olares handle automated backups and high availability for the apps and databases running on it?
Open on GitHub → Explain another repo

← beclab on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.