{"id":35878205,"url":"https://github.com/ryvieos/ryvie","last_synced_at":"2026-07-10T11:00:39.869Z","repository":{"id":291228054,"uuid":"866581304","full_name":"ryvieos/Ryvie","owner":"ryvieos","description":"Your own cloud","archived":false,"fork":false,"pushed_at":"2026-07-07T13:04:54.000Z","size":34134,"stargazers_count":3,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-07T15:07:26.616Z","etag":null,"topics":["docker","home-server","personal-cloud","self-hosted","sso"],"latest_commit_sha":null,"homepage":"https://ryvie.fr","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ryvieos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2024-10-02T14:14:55.000Z","updated_at":"2026-07-07T13:05:38.000Z","dependencies_parsed_at":"2025-05-03T08:53:49.661Z","dependency_job_id":null,"html_url":"https://github.com/ryvieos/Ryvie","commit_stats":null,"previous_names":["maisonnavejul/ryvie"],"tags_count":182,"template":false,"template_full_name":null,"purl":"pkg:github/ryvieos/Ryvie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryvieos%2FRyvie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryvieos%2FRyvie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryvieos%2FRyvie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryvieos%2FRyvie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ryvieos","download_url":"https://codeload.github.com/ryvieos/Ryvie/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryvieos%2FRyvie/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35329609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","home-server","personal-cloud","self-hosted","sso"],"created_at":"2026-01-08T17:15:50.047Z","updated_at":"2026-07-10T11:00:39.860Z","avatar_url":"https://github.com/ryvieos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n \u003cimg src=\"Ryvie-Front/src/icons/ryvielogo0.png\" alt=\"Ryvie\" width=\"160\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eRyvie · Personal Cloud OS\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cb\u003eYour personal cloud.\u003c/b\u003e\u003cbr/\u003e\n \u003csub\u003eA source-available, self-hosted personal cloud OS that turns any VPS or physical machine into your own private cloud. No command line, no need to know what a server is. Your apps, your files, your data, free and fully under your control. A privacy-first alternative to CasaOS, Umbrel and Nextcloud.\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cb\u003eEnglish\u003c/b\u003e · \u003ca href=\"README.fr.md\"\u003eFrançais\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://github.com/ryvieos/Ryvie/releases\"\u003e\u003cimg alt=\"Version\" src=\"https://img.shields.io/github/package-json/v/ryvieos/Ryvie?color=6366f1\u0026label=version\" /\u003e\u003c/a\u003e\n \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/badge/license-RSAL%20v1.1-blue\" /\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/ryvieos/Ryvie/stargazers\"\u003e\u003cimg alt=\"Stars\" src=\"https://img.shields.io/github/stars/ryvieos/Ryvie?style=flat\u0026color=f5c518\" /\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/ryvieos/Ryvie/network/members\"\u003e\u003cimg alt=\"Forks\" src=\"https://img.shields.io/github/forks/ryvieos/Ryvie?style=flat\" /\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/ryvieos/Ryvie/issues\"\u003e\u003cimg alt=\"Issues\" src=\"https://img.shields.io/github/issues/ryvieos/Ryvie\" /\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/ryvieos/Ryvie/commits\"\u003e\u003cimg alt=\"Last commit\" src=\"https://img.shields.io/github/last-commit/ryvieos/Ryvie\" /\u003e\u003c/a\u003e\n \u003ca href=\"CONTRIBUTING.md\"\u003e\u003cimg alt=\"PRs Welcome\" src=\"https://img.shields.io/badge/PRs-welcome-brightgreen\" /\u003e\u003c/a\u003e\n \u003ca href=\"https://ryvie.fr\"\u003e\u003cimg alt=\"Website\" src=\"https://img.shields.io/badge/site-ryvie.fr-6366f1\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://ryvie.fr\"\u003e Website\u003c/a\u003e ·\n \u003ca href=\"https://ryvie.fr/docs\"\u003e Documentation\u003c/a\u003e ·\n \u003ca href=\"https://ryvie.fr\"\u003e Download\u003c/a\u003e ·\n \u003ca href=\"https://github.com/ryvieos/Ryvie/issues\"\u003e Report a bug\u003c/a\u003e ·\n \u003ca href=\"CONTRIBUTING.md\"\u003e Contribute\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cimg width=\"900\" alt=\"Ryvie self-hosted personal cloud dashboard\" src=\"https://github.com/user-attachments/assets/c432252e-0cf7-46d4-8b3b-8a5e0344003d\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ci\u003e⭐ If you like Ryvie, star the repo. It genuinely helps the project gain visibility!\u003c/i\u003e\n\u003c/p\u003e\n\n---\n\n## Table of contents\n\n- [Why Ryvie?](#-why-ryvie)\n- [Features](#-features)\n- [Installation](#-installation)\n- [Tech stack](#-tech-stack)\n- [Architecture](#-architecture)\n- [Requirements](#-requirements)\n- [Contributing](#-contributing)\n- [License](#-license)\n- [Team](#-team)\n\n---\n\n## ✨ Why Ryvie?\n\nMainstream clouds (Google Drive, iCloud, Dropbox…) are convenient, but they **rent you access to your own data** and store it on servers you don't control. Ryvie flips that model. You self-host everything and own your data.\n\n- **Your own server, no command line.** Install dozens of open-source apps and services (photos, drive, CRM, automation…) in one click, never touching a terminal.\n- **Your data stays home.** On your own hardware, encrypted, never sold.\n- **As simple as a smartphone.** A grid launcher, not a Linux admin console.\n- **Multi-user with permissions.** Create accounts for your family or team, each with its own access and rights, through centralized SSO.\n- **Reachable anywhere.** Built-in private VPN tunnel (Netbird) and public-address generation, with no port forwarding and no router config.\n- **Deploy anywhere.** On a VPS or a physical machine at home, via the Ryvie OS.\n\n\u003e Ryvie brings the power of a self-hosted server with the simplicity of a smartphone.\n\n**Compared to other self-hosted platforms**, think of Ryvie as a [CasaOS](https://github.com/IceWhaleTech/CasaOS) or [Umbrel](https://github.com/getumbrel/umbrel) alternative, but with built-in centralized SSO, managed RAID storage, an integrated VPN and a private AI gateway out of the box.\n\n---\n\n## 🚀 Features\n\n| Feature | Description |\n|---|---|\n| **Grid launcher** | Responsive, smartphone-style UI: drag \u0026 drop, folders, widgets (weather, CPU/RAM, storage). |\n| **Self-hosted app store** | Dozens of open-source apps and services installable in one click, no command line (auto-detects manifests, icons, ports). |\n| **Multi-user management** | Multiple accounts with roles and permissions; centralized SSO (Keycloak + LDAP) shared by all your apps. |\n| **Remote access + public IP** | Private VPN tunnel (Netbird) and public-address generation to expose your apps, with no port forwarding or router setup. |\n| **Managed RAID storage** | Create/migrate RAID arrays (mdadm), SMART monitoring, hot-grow, move Docker across disks/partitions, all from the UI. |\n| **Private AI gateway** | Connect one LLM provider (via LiteLLM) once, shared across your apps, your key never exposed. Toggle off to save RAM. |\n| **Real-time monitoring** | Live system status over Socket.IO. |\n| **Customization** | Per-user themes, wallpaper and layout. |\n| **Flexible deployment** | On a VPS or a physical machine, via the Ryvie OS. |\n\n---\n\n## 💻 Installation\n\n\u003e **Full guide: [ryvie.fr/docs](https://ryvie.fr/docs)**\n\n1. **Install the Ryvie OS.** Download the image from [ryvie.fr](https://ryvie.fr) and install it on a VPS or a physical machine (mini-PC, server, old desktop…).\n2. **Install the Ryvie Desktop client.** Available for macOS, Windows and Linux at [ryvie.fr](https://ryvie.fr).\n3. **Sign in.** Open the client, connect to your instance, and manage your apps, grid and storage.\n\n---\n\n## 🛠️ Tech stack\n\n\u003cp\u003e\n \u003cimg alt=\"React\" src=\"https://img.shields.io/badge/React_18-20232a?logo=react\u0026logoColor=61dafb\" /\u003e\n \u003cimg alt=\"TypeScript\" src=\"https://img.shields.io/badge/TypeScript-3178c6?logo=typescript\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Node.js\" src=\"https://img.shields.io/badge/Node.js-339933?logo=node.js\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Express\" src=\"https://img.shields.io/badge/Express-000?logo=express\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Electron\" src=\"https://img.shields.io/badge/Electron-47848f?logo=electron\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Socket.IO\" src=\"https://img.shields.io/badge/Socket.IO-010101?logo=socket.io\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Docker\" src=\"https://img.shields.io/badge/Docker-2496ed?logo=docker\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Keycloak\" src=\"https://img.shields.io/badge/Keycloak-4d4d4d?logo=keycloak\u0026logoColor=white\" /\u003e\n \u003cimg alt=\"Caddy\" src=\"https://img.shields.io/badge/Caddy-1f88c0?logo=caddy\u0026logoColor=white\" /\u003e\n\u003c/p\u003e\n\n---\n\n## 🏗️ Architecture\n\n\u003cp align=\"center\"\u003e\n \u003cimg width=\"900\" alt=\"Ryvie architecture diagram\" src=\"https://github.com/user-attachments/assets/f3cb3336-77f4-47c9-86b0-de1c49169243\" /\u003e\n\u003c/p\u003e\n\n- **Backend** (`Ryvie-Back/`): Express + Socket.IO API, Docker orchestration, SSO (Keycloak/LDAP), RAID storage, AI gateway.\n- **Frontend** (`Ryvie-Front/`): React 18 + Electron for a smooth desktop experience.\n- **Data** (`/data/`): configuration, app manifests and user storage (portable bind-mounts).\n- **Reverse proxy**: Caddy (app routing, TLS, same-origin).\n\n---\n\n## 📋 Requirements\n\n| Resource | Minimum | Recommended |\n|---|---|---|\n| **CPU** | 4 cores | 4+ cores |\n| **RAM** | 8 GB | 16 GB |\n| **Storage** | 50 GB | SSD/NVMe + disk(s) for `/data` |\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome!\n\n**Before contributing**, read the [Contributing guide](CONTRIBUTING.md) and sign the [CLA](CLA.md) (automated via the CLA Assistant bot).\n\n- **[Contributing guide](CONTRIBUTING.md)**: how to set up the environment and propose changes.\n- **[CLA](CLA.md)**: Contributor License Agreement (required for any contribution).\n- **Issues**: report a bug or suggest an idea with as much detail as possible.\n- **Pull requests**: create a dedicated branch and clearly explain your changes.\n\nThe CLA protects both you (you keep ownership of your code) and the project (maintenance and evolution).\n\n---\n\n## 📄 License\n\nDistributed under the **Ryvie Source-Available License (RSAL) v1.1**. See [`LICENSE`](LICENSE) for details.\n\n---\n\n## ⚠️ Disclaimer\n\nThis project is provided **\"as is\"**, without warranty of any kind. The Ryvie team cannot be held responsible for damages, data loss or downtime resulting from the use of the platform.\n\n---\n\n## 👥 Team\n\n- **Jules Maisonnave** ([@maisonnavejul](https://github.com/maisonnavejul)) · *Initial work \u0026 Lead Development*\n- **Driss Bendahan** ([@thegreenprogrammer](https://github.com/thegreenprogrammer)) · *Infrastructure \u0026 DevOps*\n- **Paul Quiquempois** ([@Loghin01](https://github.com/Loghin01)) · *Development \u0026 CI/CD*\n\n\u003cp align=\"center\"\u003e\n \u003csub\u003eMade with ❤️ by the Ryvie team · \u003ca href=\"https://ryvie.fr\"\u003eryvie.fr\u003c/a\u003e\u003c/sub\u003e\u003cbr/\u003e\n \u003csub\u003eA single star makes a real difference for the project's visibility.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryvieos%2Fryvie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryvieos%2Fryvie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryvieos%2Fryvie/lists"}