Быстрый старт

Первое приложение разворачивается за пять минут: нужен репозиторий с кодом и доступ к панели.

Кому достаётся root, а кому нет

В сервисе две линейки, и отличаются они ровно одним — есть ли у вас доступ к самой машине:

• Виртуальная машина — машина целиком ваша: приватный SSH-ключ, пароль root, консоль (экран как у монитора), терминал. Границы — ресурсы тарифа.
• План приложений — вы выбираете план, панель сама поднимает машину с его ресурсами, а вы управляете приложениями из кабинета: сборка, запуск, состояние, журналы, обновление образа, удаление. SSH-доступа, пароля root, консоли и терминала у этой машины нет — платформа держит её сама, чтобы лимиты плана оставались лимитами. Всё, что нужно для работы, делается кнопками в кабинете.

Если понадобился root — заказывайте виртуальную машину: под неё поднимается та же технология, но уже в вашем распоряжении. Подробное сравнение линеек с примерами — в статье «Подписка или заказ ВМ».

Машину под подписку вы не видите и не выбираете: приложений может быть несколько, и они могут жить на разных машинах платформы. В кабинете они собраны в одном списке — там же адрес, по которому приложение открывается из интернета (как его настроить).

1. Заведите машину

Откройте раздел Виртуальные машины и выберите тариф. Машина создаётся на ноде Proxmox: панель отправляет задание, нода клонирует шаблон, cloud-init устанавливает агента и передаёт ему токен. Готовность видна в списке машин — статус меняется на «работает», когда агент вышел на связь.

2. Выберите план приложений

План задаёт, сколько приложений можно держать на машине и какие у них лимиты. Дальше лимиты проверяет панель при каждом действии, поэтому «переполнить» план случайно нельзя.

3. Добавьте приложение

В карточке машины нажмите Добавить приложение и укажите:

• имя — латиницей, строчными: оно станет именем каталога и префиксом контейнеров (<имя>-web);
• репозиторий — HTTPS-ссылка на Git, откуда агент клонирует код;
• ветку — обычно main или master;
• способ сборки — compose, если в репозитории есть docker-compose.yml или compose.yml, либо dockerfile, если нужен docker build.

Перед сборкой платформа проверит манифест и compose-файл: привилегированные контейнеры, сеть хоста, проброс устройств и монтирование чужих каталогов запрещены (что именно). Отказ приходит с указанием нарушения — до сборки, а не после получаса ожидания.

4. Дождитесь сборки

Агент выполняет по очереди: clone → build → run. Прогресс и вывод видны в журнале приложения, поэтому ошибку в Dockerfile или в compose-файле видно сразу, без захода по SSH.

5. Проверьте здоровье и откройте домен

После запуска доступны команды статус и health: первая показывает состояние контейнеров, вторая — прошло ли приложение проверку доступности. Домен и сертификат подключаются в разделе Домены и SSL.

Меню кабинета

На широком экране меню можно свернуть кнопкой «Свернуть меню» внизу колонки: остаются только значки, а подписи показываются при наведении. Таблицы и формы получают ещё около 170 пикселей ширины. Выбор запоминается в браузере — при следующем входе меню будет в том же виде, вернуть подписи можно кнопкой «Развернуть меню».

На телефоне и планшете меню выдвигается кнопкой в шапке и всегда занимает всю ширину: там сворачивать нечего.

Что дальше

• Вход в аккаунт и безопасность сессии — как устроен вход и что делать, если вход был не ваш.

• Деплой из Git — ветки, приватные репозитории, токены;

• Переменные окружения — как передать приложению секреты, не храня их в панели;

• Управление контейнерами — что делает каждая команда агента.