diff --git a/doc/i18n/README.ua.md b/doc/i18n/README.ua.md
new file mode 100644
index 00000000..17c29653
--- /dev/null
+++ b/doc/i18n/README.ua.md
@@ -0,0 +1,127 @@
+
+Інтернет-ОС! Безкоштовна, відкрита та самостійно-хостована.
+
+
+ 
+
+
+ « ЖИВИЙ ДЕМО »
+
+
+ Puter.com
+ ·
+ SDK
+ ·
+ Discord
+ ·
+ YouTube
+ ·
+ Reddit
+ ·
+ X (Twitter)
+ ·
+ Bug Bounty
+
+
+
+
+
+
+## Puter
+
+Puter - це передова, відкрита операційна система Інтернету, яка має багатий функціонал, виняткову швидкість та високу розширюваність. Puter може бути використаний як:
+
+- Особистий хмарний сервіс з підвищеною конфіденційністю, щоб зберігати всі ваші файли, додатки та ігри в безпечному місці, доступному з будь-якого місця та в будь-який час.
+- Платформа для створення та публікації веб-сайтів, веб-додатків та ігор.
+- Альтернатива Dropbox, Google Drive, OneDrive тощо з новим інтерфейсом та потужними функціями.
+- Віддалена робоча область для серверів та робочих станцій.
+- Дружній відкритий проект та спільнота для вивчення веб-розробки, хмарних обчислень, розподілених систем та багато іншого!
+
+
+
+## Початок роботи
+
+### 💻 Локальна розробка
+
+```bash
+git clone https://github.com/HeyPuter/puter
+cd puter
+npm install
+npm start
+```
+
+Це запустить Puter за адресою http://puter.localhost:4100 (або наступний доступний порт).
+
+
+
+### 🐳 Docker
+
+```bash
+mkdir puter && cd puter && mkdir -p puter/config puter/data && sudo chown -R 1000:1000 puter && docker run --rm -p 4100:4100 -v `pwd`/puter/config:/etc/puter -v `pwd`/puter/data:/var/puter ghcr.io/heyputer/puter
+```
+
+
+
+### 🐙 Docker Compose
+
+#### Linux/macOS
+
+```bash
+mkdir -p puter/config puter/data
+sudo chown -R 1000:1000 puter
+wget https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml
+docker compose up
+```
+
+
+
+#### Windows
+
+```powershell
+mkdir -p puter
+cd puter
+New-Item -Path "puter\config" -ItemType Directory -Force
+New-Item -Path "puter\data" -ItemType Directory -Force
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/HeyPuter/puter/main/docker-compose.yml" -OutFile "docker-compose.yml"
+docker compose up
+```
+
+
+
+### ☁️ Puter.com
+
+Puter доступний як хостована послуга на [**puter.com**](https://puter.com).
+
+
+
+## Системні вимоги
+
+- **Операційні системи:** Linux, macOS, Windows
+- **Оперативна пам'ять:** Мінімум 2 ГБ (рекомендовано 4 ГБ)
+- **Дисковий простір:** 1 ГБ вільного місця
+- **Node.js:** Версія 16+ (рекомендовано версію 22+)
+- **npm:** Остання стабільна версія
+
+
+
+## Підтримка
+
+Зв'яжіться з розробниками та спільнотою через ці канали:
+
+- Звіт про помилку або запит функції? Будь ласка, [створіть питання](https://github.com/HeyPuter/puter/issues/new/choose).
+- Discord: [discord.com/invite/PQcx7Teh8u](https://discord.com/invite/PQcx7Teh8u)
+- X (Twitter): [x.com/HeyPuter](https://x.com/HeyPuter)
+- Reddit: [reddit.com/r/puter/](https://www.reddit.com/r/puter/)
+- Mastodon: [mastodon.social/@puter](https://mastodon.social/@puter)
+- Проблеми безпеки? [security@puter.com](mailto:security@puter.com)
+- Напишіть розробникам на [hi@puter.com](mailto:hi@puter.com)
+
+Ми завжди раді допомогти вам з будь-якими питаннями. Не соромтеся запитувати!
+
+
+
+## Ліцензія
+
+Цей репозиторій, включаючи всі його вміст, підпроекти, модулі та компоненти, ліцензовано за [AGPL-3.0](https://github.com/HeyPuter/puter/blob/main/LICENSE.txt), якщо не зазначено інше. Сторонні бібліотеки, включені в цей репозиторій, можуть підлягати власним ліцензіям.
+
+