Як встановити Cloudron на VPS з Ubuntu
Покрокове встановлення Cloudron на чистий Ubuntu VPS: wildcard DNS, setup script, перший запуск, вимоги для 2–10 застосунків, пошта, TLS і backup.
Встановлення Cloudron на VPS: коротка версія
Щоб встановити Cloudron на VPS, потрібен чистий сервер Ubuntu, щонайменше 2 GB RAM і домен, DNS-записи якого ви можете редагувати. Саме встановлення складається з трьох команд і одного перезавантаження. Майже всі проблеми виникають або до цього етапу (неправильний базовий образ, неправильний тип віртуалізації), або після нього (DNS, пошта, резервні копії).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron встановлює, оновлює та резервно копіює self-hosted застосунки, а також випускає для них сертифікати TLS (transport layer security). Кожен застосунок працює в Docker, перед усіма застосунками працює nginx, а кожен застосунок отримує власний піддомен вашого домену. Саме тому в цьому випадку спочатку потрібно налаштувати DNS.
Чому Cloudron прискіпливо ставиться до базової ОС
Скрипт встановлення перевіряє сервер до початку встановлення. Якщо перевірка не проходить, потрібно замовляти новий сервер. Прочитайте ці вимоги до вибору образу. Наведені в цьому розділі перевірки інсталятора актуальні станом на October 13, 2026; поточна документація з встановлення вимагає чистий сервер Ubuntu 26.04.
- Лише Ubuntu і лише три релізи. У разі будь-якої іншої ОС скрипт завершує роботу з
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 відхиляється, а документація з встановлення тепер вимагає чистий сервер Ubuntu 26.04. Debian, Rocky і Alpine не підтримуються. Для Ubuntu 24.04 потрібен Cloudron 8 або новіший; скрипт перевіряє це автоматично. - Лише 64-розрядні процесори Intel або AMD:
Error: Cloudron only supports amd64/x86_64. VPS на ARM не підтримується. - Лише повна апаратна віртуалізація. На VPS на основі контейнерів скрипт зупиняється з
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization, оскільки виявляє контейнер за допомогоюsystemd-detect-virt --container. KVM підтримується. OpenVZ і LXC не підтримуються. - Коренева файлова система має бути
ext4абоxfs. В іншому разі з’являєтьсяError: Cloudron requires '/' to be ext4 or xfs; так проявляється несумісність образів btrfs і zfs. - Щонайменше 941 MB RAM, виміряної за допомогою
free -m, і 18 GB у/, де розмір визначається за розміром кореневої файлової системи. Повідомлення про помилку вимагає 20GB, але сама перевірка проходить для кореневої файлової системи розміром 19 GB. - Дійсно чистий сервер. Якщо
nginx,dockerабоnodeуже встановлено, скрипт відмовляється продовжувати зError: Some packages like nginx/docker/nodejs are already installed.
Саме щодо останньої перевірки часто виникають суперечки, тому пояснимо її причину. Cloudron встановлює зафіксовані версії Docker, nginx, Node.js і MySQL, створює конфігурацію nginx для кожного розміщеного застосунку та самостійно керує правилами брандмауера iptables. Docker, встановлений учора, може мати неправильну версію, тому скрипт завершує роботу без змін і вказує почати з чистого встановлення Ubuntu. Cloudron керує всією машиною, тому використовуйте для нього окремий VPS.
Є ще одна перевірка, яку легко пропустити. На старішому процесорі без AVX (advanced vector extensions) скрипт виводить CPU has no AVX support. MongoDB will be disabled, а всі застосунки, яким потрібен MongoDB, стають недоступними для встановлення. Перевірте процесор до замовлення сервера за допомогою grep -m1 -o avx /proc/cpuinfo: на сумісному хості команда виводить avx, а на старому — нічого.
Скільки оперативної пам’яті потрібно Cloudron?
Перевірка інсталятора від October 13, 2026 відмовлялася запускатися за обсягу менше ніж 941 MB; Error: Cloudron requires atleast 1GB physical memory. Поточна документація вимагає 2 GB RAM і 20 GB дискового простору. Обидва значення є мінімальними для платформи, а не для платформи разом із вашими застосунками. Cloudron запускає Docker, nginx, власний сервіс box і поштовий стек, а під час розгортання застосунків створює спільні служби баз даних. Після чистої інсталяції виконайте docker ps і порахуйте їх.
Ліміти пам’яті застосунків встановлюються додатково до цього базового обсягу. Кожен пакет застосунку має невеликий ліміт за замовчуванням. Збільшити його можна повзунком у розділі Resources застосунку. Коли застосунок перевищує свій ліміт, він перезапускається, а ви отримуєте сповіщення OOM (out of memory). Тому сервер, на якому постійно перезапускається один застосунок, зазвичай має проблему з лімітом, а не помилку в застосунку.
Для замовлення сервера я рекомендую такі параметри. Це рекомендації для сервера, який не доведеться перебудовувати наступного місяця. Це не результати вимірювань продуктивності.
Дані, на яких побудовано графік
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Два застосунки стабільно працюватимуть на 4 GB RAM і 60 GB дискового простору. Для приблизно десяти застосунків потрібно 16 GB RAM і 240 GB дискового простору, оскільки базовий обсяг платформи не зменшується, а кожен застосунок додає Docker image, базу даних і власні дані. Диск заповнюється швидше, ніж очікують: images, дані застосунків і локальні резервні копії використовують один том, доки ви не перенесете резервні копії за межі сервера.
Cloudron надає кожному застосунку необмежений swap, тому встановлений вами ліміт пам’яті застосовується лише до RAM. В образі VPS без swap-файлу swapon --show не виводить нічого, а дефіцит пам’яті одразу призводить до перезапусків OOM, а не до повільної роботи застосунку. Додати 2 GB swap — недорога страховка, але це не замінює реальну пам’ять. Різниця між тарифами VPS невелика порівняно з кількістю годин, які ви витратите на налаштування лімітів, тому перегляньте скільки насправді коштує VPS і виберіть наступний за розміром тариф.
DNS: wildcard-запис, необхідний для роботи піддоменів застосунків
Cloudron розміщує панель керування на my.example.com, а кожен застосунок — на власному піддомені, тому DNS є попередньою умовою, а не пізнішим кроком. До першого відкриття панелі керування вкажіть у цих записах публічну IP-адресу сервера:
my.example.comяк A-запис. Це панель керування.*.example.comяк A-запис. Саме цей запис забезпечує роботу піддоменів застосунків, томуwiki.example.comіgit.example.comпочнуть розв’язуватися одразу після встановлення цих застосунків.example.comяк A-запис, лише якщо потрібен застосунок на основному домені без піддомену.
Wildcard-запис має нижчий пріоритет, ніж явний запис, тому наявний www.example.com, який вказує в інше місце, продовжить працювати.
Під час налаштування ви обираєте, як Cloudron надалі працюватиме з DNS:
- API-провайдер. Cloudron зберігає токен для Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS та інших провайдерів (загалом 22 інтеграції з API DNS, без Wildcard, Manual і No-op), а потім сам створює всі записи, включно з поштовими записами.
- Wildcard. Ви вручну додаєте запис
*, а Cloudron нічого не створює. - Manual. Cloudron показує кожен запис і чекає, доки ви його додасте, перед кожним встановленням застосунку.
Wildcard DNS-запис — це не wildcard-сертифікат. Типовий провайдер сертифікатів — Let's Encrypt Prod - Wildcard. Він підтверджує право власності через DNS, тому працює лише з API-провайдером. На бекендах Wildcard або Manual Let's Encrypt видає окремі сертифікати, перевірені через HTTP. Для їх видачі та поновлення потрібен вхідний порт 80. Натомість можна вимкнути інтеграцію з Let's Encrypt і завантажити власний wildcard-сертифікат. Тоді порт 80 не буде постійно потрібен для перевірки сертифіката. Якщо ваш реєстратор або DNS-хостинг є в списку API, використовуйте його: поштові записи та сертифікати більше не потребуватимуть ручного налаштування.
Перш ніж продовжити, виконайте перевірку. dig +short my.example.com і dig +short anything.example.com мають обидва вивести IP-адресу вашого сервера. На бекенді Wildcard, якщо запит до wildcard-запису нічого не виведе, застосунки згодом не працюватимуть, хоча панель керування працюватиме нормально.
Якщо домен працює через Cloudflare, встановіть для записів режим DNS only. Проксі передає лише HTTP і HTTPS, тому поштові порти перестануть працювати. Для вебзастосунків через проксі в розділі Network Cloudron можна дозволити довіряти опублікованим Cloudflare діапазонам IP-адрес, щоб відновлювати адресу відвідувача із forwarded headers.
Запустіть скрипт налаштування
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupЗапустіть його від імені root або через sudo, інакше першим повідомленням буде This script should be run as root.. Інсталяція триває кілька хвилин і не виводить повідомлень під час роботи, оскільки вивід apt і завантаження образів Docker записуються у файл журналу. Переглядайте його з другого сеансу SSH:
tail -f /var/log/cloudron-setup.logПід час перевірки інсталятора 13 жовтня 2026 року він вивів After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup., після чого — адресу сервера, а потім запитав The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Відповідайте yes. Цей інсталятор також підтримував прапорець --skip-reboot, щоб відкласти перезапуск.
Перший запуск: домен, DNS-бекенд і обліковий запис адміністратора
Відкрийте https://<server-ip> і прийміть попередження браузера. Сертифікат самопідписаний, оскільки Cloudron ще не знає ваш домен і тому не може запросити сертифікат у центру сертифікації. У Chrome натисніть Advanced, а потім Proceed to <ip> (unsafe). У Firefox натисніть Advanced, а потім Accept the Risk and Continue.
На першому екрані вкажіть свій домен. Введіть example.com, після чого панель керування стане доступною за адресою my.example.com. Замість цього можна використовувати субдомен, наприклад cloudron.example.com, і тоді панель керування буде доступна за адресою my.cloudron.example.com. Виберіть DNS-бекенд, вставте API-токен, якщо він у вас є, і створіть обліковий запис адміністратора з адресою електронної пошти, яку ви регулярно перевіряєте: для скидання пароля та сповіщень платформи використовується саме ця адреса.
Після збереження Cloudron запросить сертифікати та перемістить панель керування на https://my.example.com. Після цього URL-адреса з IP-адресою перестане працювати, тому додайте нову адресу в закладки.
Сертифікати: що поновлюється і коли це припиняється
Поновлення сертифіката виконується автоматично відповідно до ACME Renewal Information (ARI) — розкладу, який публікує центр сертифікації. На практиці сертифікат поновлюється приблизно за місяць до завершення строку дії. Якщо поновлення не вдається, повідомлення надсилається на обліковий запис адміністратора, а після завершення строку дії сертифіката використовується вбудований самопідписаний сертифікат. Саме через це в браузері з’являється попередження для сайту, який ще вчора працював.
У більшості випадків причина одна з двох. Для HTTP-перевірки потрібен вхідний порт 80. Тому закриття порту 80 через припущення, що «все одно використовується HTTPS», порушує поновлення для застосунків, які використовують HTTP-перевірку Let’s Encrypt із Wildcard або Manual DNS backend. Для DNS-перевірки потрібен API token зі збереженим правом запису. Тому ротація цього токена або звуження його прав непомітно порушує поновлення, доки не надійде попередження електронною поштою.
У поданні Domains є кнопка Renew All для негайного примусового запуску спроби, а також провайдер Let's Encrypt Staging для тестування. Staging-сертифікати навмисно не довірені браузерами. У цьому і полягає їхнє призначення: тестування не витрачає production rate limits. Staging має власні обмеження, зокрема 200 невдалих перевірок авторизації для кожного ідентифікатора, облікового запису та години.
Чи варто використовувати вбудований поштовий сервер?
Cloudron постачається з повним поштовим стеком: поштовими скриньками IMAP, submission, фільтрами sieve і підписуванням DKIM (domainkeys identified mail). Увімкніть його для кожного домену в розділі Email панелі керування. Найскладніше — забезпечити доставлення пошти, і Cloudron не відповідає за більшість цих проблем.
- Більшість VPS-провайдерів блокують вихідний порт 25 для боротьби зі спамом. Деякі знімають блокування після звернення до служби підтримки. Перевірте порт із сервера за допомогою
nc -zv aspmx.l.google.com 25(якщо команди немає, встановітьnetcat-openbsd). Відкриті порти відображаються якsucceeded, а підключення до заблокованого порту очікує до завершення тайм-ауту. - Запис PTR (зворотний DNS) налаштовує VPS-провайдер, а не DNS-хостинг. Під час прямого надсилання пошти із сервера цей запис має збігатися з іменем поштового хоста. Smart host усуває вимогу до PTR.
- Записи SPF, DKIM і DMARC автоматично створюються для вас у DNS-бекенді з API. У бекендах Wildcard або Manual додайте їх вручну. Якщо запис DKIM відсутній, підпис кожного надісланого повідомлення неможливо перевірити.
Для більшості користувачів оптимальна схема — отримувати пошту на Cloudron, а надсилати її через relay, наприклад SendGrid, Postmark, Mailgun або Amazon SES, налаштований у поданні Email. Relay має дозволяти надсилання від будь-якої адреси вашого домену. Інакше сповіщення застосунків від різних відправників відхилятимуться. Якщо пошта є основною причиною придбання сервера, запустіть виділений поштовий сервер, наприклад Mailcow на окремому сервері з власною IP-репутацією.
Якщо ви взагалі не використовуєте Cloudron Email, заблокуйте порти 25, 465, 587, 993 і 4190 у firewall вашого провайдера. Робіть це там, а не на сервері, оскільки Cloudron сам записує правила iptables і очікує, що керуватиме ними. Це протилежність звичайному VPS, де ви самостійно керуєте правилами ufw.
Налаштуйте сховище резервних копій до того, як воно знадобиться
За замовчуванням резервні копії зберігаються в локальній файловій системі в /var/backups, на тому самому диску, що й усі інші дані. У документації прямо зазначено: «Зберігати резервні копії на тому самому фізичному диску, що й сервер платформи, небезпечно». Відмова одного диска одночасно виведе з ладу застосунки та резервні копії.
Відкрийте Backups, потім Backup Sites і в перший день налаштуйте інше сховище. Зазвичай використовують S3-compatible object storage (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces або бакет MinIO на другому сервері). Також підтримуються SSHFS, NFS, CIFS і звичайні файлові системи.
Є три налаштування, від яких залежить практична цінність резервної копії:
- Format.
tgzстворює один стиснений архів для кожного застосунку та під час кожного запуску повторно завантажує весь архів.rsyncзавантажує лише змінені файли. Для великого Nextcloud це значно дешевше, але створює набагато більше запитів до API сховища. - Encryption. Необов’язкове AES-256-шифрування охоплює вміст файлів і їхні імена. Cloudron не зберігає копію пароля. Якщо його втратити, резервні копії не зможе розшифрувати ніхто, зокрема й ви. Перш ніж натискати кнопку збереження, збережіть пароль у self-hosted менеджері паролів.
- Retention. Значення задають кількістю копій, наприклад 7 daily і 4 weekly. Тривале зберігання в object storage щомісяця збільшує рахунок, тому виберіть кількість копій, за зберігання яких ви готові постійно платити.
Після цього перевірте відновлення. Встановіть невеликий застосунок, відновіть його з dashboard і переконайтеся, що він запускається разом із даними. Резервна копія, з якої ще жодного разу не виконували відновлення, є лише припущенням.
Обмеження безкоштовного тарифу
Станом на October 2026 безкоштовний тариф обмежений двома встановленими застосунками. Усе інше входить до тарифу: оновлення застосунків, резервні копії для кожного застосунку, firewall, mail server і single sign-on. Третій застосунок — це межа, після якої потрібна ліцензія. Платні тарифи знімають обмеження на кількість застосунків, а дорожчий тариф додатково надає групи й ролі користувачів, directory server і кілька майданчиків для резервного копіювання. Ціни змінюються, тому перевіряйте сторінку з цінами Cloudron, а не покладайтеся на число в tutorial.
Ліцензія охоплює одну інсталяцію Cloudron, тому два невеликі сервери коштують удвічі дорожче за один потужніший сервер. Через таку модель оплати більшість користувачів обирає один потужніший VPS, що суперечить типовій рекомендації розподіляти сервіси між кількома машинами. Враховуйте це під час вибору конфігурації сервера, оскільки поділ пізніше означатиме подвійну оплату.
Коли щось не працює
Почніть із вбудованої перевірки. Вона послідовно перевіряє DNS, сертифікати, диск, пам’ять і кожен сервіс та повідомляє, який тест завершився помилкою:
sudo cloudron-support --troubleshootПісля цього скористайтеся стандартними інструментами systemd (менеджера системи та сервісів). systemctl status box показує стан самого сервісу Cloudron, journalctl -u box -n 100 виводить його останні журнали, а journalctl -u docker перевіряє базове середовище виконання контейнерів. Усе, що пішло не так під час встановлення, записується до /var/log/cloudron-setup.log.
Якщо dashboard не завантажується, проблема зазвичай у DNS або firewall провайдера, а не в Cloudron. Виконайте dig +short my.example.com на своєму ноутбуці та переконайтеся, що порти 80 і 443 відкриті в мережевому firewall провайдера. Це окремий механізм керування, не пов’язаний із власними правилами сервера. У перевірці інсталятора від October 13, 2026 повторний запуск було відхилено з повідомленням Error: Cloudron is already installed. To reinstall, start afresh; чисте рішення — перебудувати сервер.
Коли Cloudron не відповідає вашим потребам
Cloudron підходить, якщо вам потрібні застосунки, а не інфраструктура. Він погано підходить, якщо ви хочете запускати власні контейнери на власних умовах, оскільки Cloudron керує nginx, Docker і firewall та перезаписує внесені вами зміни. Якщо ваш план — каталог із compose-файлами, Traefik перед власними стеками Docker Compose забезпечить такий самий автоматичний TLS і маршрутизацію субдоменів без платформи поверх них. Якщо ви ще не зробили вибір, у матеріалі Cloudron, CasaOS і Coolify: порівняння ці рішення наведено поруч, а розширений список того, що можна розмістити на власному сервері — кращий початок, ніж інструкція зі встановлення.
FAQ
Скільки RAM потрібно Cloudron на VPS?
Перевірка інсталятора від October 13, 2026 відмовлялася запускатися, якщо доступно менше ніж 941 MB; у поточній документації вказано 2 GB, але це мінімальний обсяг для самої платформи без застосунків. Cloudron запускає Docker, nginx, власний сервіс box і поштовий стек, а під час розгортання застосунків створює спільні сервіси баз даних. Для двох застосунків закладайте 4 GB, а для приблизно десяти — 16 GB. Також додайте swap-файл, оскільки Cloudron дозволяє застосункам необмежене використання swap, а сервер без swap перетворює дефіцит пам’яті на перезапуски.
Чи можна встановити Cloudron на Debian або на сервер, де вже працює Docker?
Ні те, ні інше не підтримується. Під час перевірки інсталятора від October 13, 2026 скрипт зупинявся на непідтримуваних релізах із повідомленням Cloudron requires Ubuntu 22.04, 24.04, 26.04 і відмовлявся працювати на серверах, де вже були присутні nginx, docker або node. Поточна документація з інсталяції вимагає чистий образ Ubuntu та виключає Debian, Rocky і Alpine. Почніть із чистого образу Ubuntu на KVM VPS.
Чому субдомени моїх застосунків не працюють, хоча dashboard відкривається?
У Wildcard backend перевірте wildcard DNS-запис. Під час налаштування створюється або потрібен A-запис для my.example.com, тому dashboard визначається, тоді як wiki.example.com повертає NXDOMAIN, а браузер повідомляє, що сайт не знайдено. Додайте A-запис для *.example.com, який вказує на IP-адресу сервера, а потім перевірте його за допомогою dig +short wiki.example.com перед інсталяцією застосунку.
Чи потрібно використовувати поштовий сервер Cloudron?
Ні. Можна вимкнути вхідну пошту та надсилати листи через зовнішній relay, наприклад Postmark, Mailgun або Amazon SES. Це безпечніший варіант, якщо ваш провайдер блокує вихідний порт 25 або IP-адреса не має поштової репутації. Якщо повністю не використовувати Cloudron Email, закрийте порти 25, 465, 587, 993 і 4190 у firewall провайдера, а не на сервері.
Що станеться, коли я досягну обмеження у два застосунки на безкоштовному плані?
Для інсталяції третього застосунку потрібна платна підписка. Уже запущені застосунки не змінюються: вони продовжують оновлюватися, резервно копіюватися й отримують сертифікати. Додавання підписки знімає обмеження без повторної інсталяції, тому безкоштовний план зручно використовувати для тестування платформи на реальному домені.