From ebce5a4c24af789871c16d8334c1ff1ba281be51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Wed, 6 May 2026 17:48:09 +0900
Subject: [PATCH] Update README.md

---
 README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 64 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a679b77..49d2443 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,64 @@
-# virtuality
-Virtuality — лёгкая панель виртуализации в стиле Proxmox на базе KVM, QEMU, libvirt и Cockpit.
+# Virtuality
+
+**Virtuality** — лёгкая платформа виртуализации в стиле Proxmox на базе **KVM**, **QEMU**, **libvirt** и **Cockpit**.
+
+Цель проекта — создать понятную, расширяемую и аккуратную систему для управления виртуальными машинами, хранилищами, сетевыми мостами, резервными копиями и будущей кластерной инфраструктурой.
+
+> Текущий статус: ранняя стадия разработки.  
+> Virtuality пока не является полноценной заменой Proxmox — это фундамент для создания собственной платформы виртуализации.
+
+---
+
+## Возможности
+
+### Текущая база
+
+- установка KVM/QEMU;
+- настройка libvirt;
+- веб-интерфейс Cockpit;
+- модуль Cockpit Machines для управления виртуальными машинами;
+- структура хранения ISO-образов, дисков виртуальных машин и бэкапов;
+- libvirt storage pools;
+- базовая подготовка firewall;
+- чистая структура проекта для дальнейшей разработки.
+
+### Планируемые возможности
+
+- собственная веб-панель управления;
+- управление жизненным циклом виртуальных машин;
+- загрузка и управление ISO-образами;
+- обзор хранилищ;
+- планировщик резервного копирования;
+- менеджер сетевых bridge-интерфейсов;
+- роли пользователей и права доступа;
+- диагностика ноды;
+- система установки и автообновления;
+- архитектура с заделом под кластер.
+
+---
+
+## Поддерживаемые системы
+
+Целевые системы:
+
+- Debian 12;
+- Ubuntu Server 22.04;
+- Ubuntu Server 24.04.
+
+Рекомендуемая конфигурация сервера:
+
+- чистая установка сервера;
+- включённая аппаратная виртуализация в BIOS/UEFI;
+- от 2 ядер CPU;
+- от 4 GB RAM;
+- SSD или NVMe-хранилище.
+
+---
+
+## Установка
+
+Клонировать репозиторий:
+
+```bash
+git clone https://github.com/viktor138irk/virtuality.git
+cd virtuality