Coolify – это открытая self-hosted платформа для развертывания приложений, баз данных и сервисов. Это альтернатива Heroku, Vercel и Netlify, которая позволяет управлять инфраструктурой на собственном сервере.
Вы можете создать VPS с Coolify, чтобы в несколько кликов разворачивать приложения напрямую из GitHub, GitLab, Bitbucket или Gitea, поднимать базы данных (PostgreSQL, MySQL, MariaDB, MongoDB, Redis, ClickHouse и другие), запускать готовые сервисы из библиотеки шаблонов и управлять всем этим из единой панели. Coolify сам выпускает и продлевает SSL-сертификаты Let's Encrypt, настраивает обратный прокси, ведет логи и собирает метрики использования ресурсов.
Графический интерфейс Coolify позволяет настраивать автоматический деплой по push в репозиторий, описывать переменные окружения, привязывать произвольные домены к приложениям и наблюдать за состоянием контейнеров в режиме реального времени.
Кроме того, Coolify предлагает множество полезных функций: автоматическое резервное копирование баз данных с выгрузкой в S3-совместимое хранилище, поддержку команд и ролей, webhook-уведомления в Telegram, Discord и Slack, подключение и оркестрацию нескольких внешних серверов из одной панели, а также готовые шаблоны для запуска популярных open-source приложений – от WordPress и Ghost до Plausible и Umami.
Coolify предоставляет полноценный REST API и токены доступа, поэтому платформа отлично подходит для тех, кто пишет код вместе с AI-агентами (Claude Code, Cursor, Codex и аналогичными). Достаточно передать агенту IP-адрес сервера и API-токен – и он сам подключит ваш проект к Coolify, создаст ресурс, настроит переменные окружения и домен и запустит деплой. Вам не придется переключаться между IDE и панелью управления: весь цикл от написания кода до выкатки в продакшен агент может выполнять напрямую через API.
Coolify от Beget – это готовая к работе сборка Coolify с вашим или бесплатным доменом и установленным SSL-сертификатом, которая устанавливается в течение пары минут в несколько кликов.
Состав приложения
- Ubuntu 24.04
- Docker, последняя версия
- Coolify
- Traefik
Установка Coolify
Для установки Coolify вместе с созданием сервера потребуется указать следующие дополнительные параметры:
- Доменное имя, по которому будет доступна панель управления Coolify. Вы можете как выбрать свой собственный домен, так и зарегистрировать новый. Помимо этого вы можете воспользоваться бесплатным доменом в зоне
.beget.app. На указанный домен будет установлен бесплатный SSL-сертификат. - Email администратора. Этот email будет использоваться для доступа к Coolify.
- Пароль администратора. Этот пароль будет использоваться для доступа к Coolify.
После создания виртуального сервера мы автоматически развернем и настроим Coolify. Обычно это занимает до 5 минут. Вы получите уведомление после завершения развертывания.
Начало работы
Для начала работы с Coolify перейдите по адресу https://my-domain.beget.app, где my-domain.beget.app – выбранный вами домен. Вы также можете перейти к приложению с помощью ссылки в окне информации об установленном приложении в панели управления виртуальным сервером.
Для входа используйте email и пароль, которые вы указали при создании VPS, также они были отправлены на контактный email аккаунта и доступны в окне информации об установленном приложении в панели управления виртуальным сервером.
При первом входе Coolify запустит онбординг-мастер, который поможет подготовить платформу к работе за несколько шагов:
- Welcome – приветственный экран с кратким описанием возможностей Coolify.
- Server – Coolify предложит выбрать сервер, на котором будут разворачиваться ресурсы:
- «This Machine» – тот же VPS, на котором установлен Coolify. Coolify работает с ним напрямую через локальный Docker-сокет, дополнительная настройка не требуется. Подходит, если вы хотите разворачивать приложения и базы данных рядом с панелью управления.
- «Remote Server» – отдельный сервер, к которому Coolify будет подключаться по SSH. Подходит, если вы хотите вынести нагрузку с сервера, где установлен Coolify, разделить prod- и staging-окружения или управлять несколькими серверами из одной панели.
Если вы выбрали «This Machine», Coolify сразу перейдет к следующему шагу – сервер уже добавлен и настроен сборкой Beget.
Если вы выбрали «Remote Server», потребуется сначала настроить SSH-ключ для подключения, а затем задать параметры самого сервера:
- На первом шаге Coolify предложит настроить приватный SSH-ключ. Вставьте свой существующий приватный ключ в поле формы либо нажмите «Generate new SSH Key», чтобы Coolify сгенерировал новую пару ключей. Заполните поля Name и при необходимости Description, затем нажмите «Save» – ключ будет сохранен в хранилище Coolify.
- Скопируйте публичный ключ, который отобразит Coolify, подключитесь к удаленному серверу по SSH и добавьте его в файл
~/.ssh/authorized_keysпользователя, под которым будет работать Coolify (обычноroot). - После сохранения ключа Coolify перейдет к форме добавления сервера. Заполните поля:
- Server Name – произвольное имя сервера;
- IP Address/Hostname – публичный IP-адрес удаленного сервера;
- Description – описание (опционально).
- Убедитесь, что на удаленном сервере установлен Docker. Если его нет, Coolify попробует установить его автоматически на следующем шаге.
- Нажмите «Validate Server & Continue» – Coolify проверит SSH-подключение, версию Docker и при необходимости установит недостающие компоненты.
После успешной валидации удаленный сервер будет доступен для выбора при создании ресурсов.
- Create a new Project – создайте первый проект, указав его название и при необходимости описание. Проект – это логическая группа, в которой будут храниться приложения, базы данных и сервисы. Внутри проекта Coolify автоматически создаст окружение
production; при желании вы сможете добавить дополнительные окружения (staging,developmentи т. д.) позже.
После создания проекта онбординг завершается – нажмите кнопку «Deploy Resource», и Coolify перейдет в раздел «New Resource», где можно выбрать тип первого ресурса для развертывания: приложение из Git-репозитория, базу данных, готовый сервис из библиотеки или Docker Compose стек.
Для развертывания последующих приложений нажмите кнопку «+ Add Resource» на дашборде в карточке нужного проекта или на странице самого проекта – откроется тот же раздел «New Resource» с выбором типа ресурса, включая приложения из Git-репозитория, базы данных, Docker Compose стеки и десятки готовых шаблонов open-source сервисов.
Желаем удачной работы с платформой Coolify!
FAQ
Все конфигурационные файлы Coolify находятся в директории /data/coolify:
- в файле
source/.envнаходятся переменные окружения Coolify и связанных контейнеров; - в файле
source/docker-compose.ymlнаходится конфигурация контейнеров; - в директории
proxy/хранятся конфигурация и сертификаты Traefik; - в директории
databases/– данные созданных через Coolify баз данных; - в директории
backups/– локальные резервные копии.
Coolify использует SMTP для отправки приглашений в команду, уведомлений о статусе деплоев и системных сообщений.
Для настройки отправки писем через наши почтовые серверы выполните следующие шаги:
- В панели управления в разделе «Почта» создайте почтовый ящик, с которого будет отправлять письма Coolify.
- В панели управления Coolify перейдите в раздел «Notifications» → «Email».
- Включите переключатель «Enabled» и заполните поля:
- SMTP Host:
smtp.beget.com - SMTP Port:
465 - Encryption:
SSL/TLS - SMTP Username: адрес почтового ящика, созданного на шаге 1
- SMTP Password: пароль от почтового ящика
- From Address: адрес почтового ящика, созданного на шаге 1
- From Name: произвольное имя отправителя, например, Coolify
- SMTP Host:
- Нажмите «Save», затем «Send Test Email», чтобы проверить корректность настроек.
Coolify умеет управлять несколькими серверами из одной панели – это удобно, если вы хотите разделить prod- и staging-окружения или вынести базы данных на отдельный VPS.
Для подключения дополнительного сервера выполните следующие шаги:
- В панели управления Coolify перейдите в раздел «Servers» → «+ Add».
- Заполните поля:
- Name: произвольное имя сервера;
- IP Address: публичный IP-адрес VPS, который вы хотите подключить;
- User: пользователь SSH, обычно
root; - Port: порт SSH, по умолчанию
22.
- Скопируйте публичный SSH-ключ Coolify, который отобразится в форме.
- Подключитесь к новому серверу по SSH и добавьте скопированный ключ в файл
~/.ssh/authorized_keysпользователя, указанного на предыдущем шаге. - Установите на новом сервере Docker, если он еще не установлен.
- Вернитесь в Coolify и нажмите «Validate Server» – Coolify проверит подключение, версию Docker и установит необходимые компоненты.
- После успешной валидации сервер появится в списке доступных при создании новых ресурсов.
Coolify предоставляет REST API, через который можно автоматизировать создание ресурсов, запуск деплоев, управление переменными окружения, доменами и серверами. Это удобно, если вы пишете код вместе с AI-агентом (Claude Code, Cursor, Codex и аналогичными) и хотите, чтобы агент сам разворачивал проект на вашем сервере – без ручной настройки панели управления.
Чтобы выдать агенту доступ, сгенерируйте API-токен:
- В панели управления Coolify перейдите в раздел «Keys & Tokens» → «API Tokens».
- Укажите имя токена и выберите права доступа (можно выбрать несколько):
- root – полный доступ, включая управление серверами, командами и настройками инстанса;
- write – создание и изменение ресурсов: приложений, баз данных, сервисов, доменов, переменных окружения;
- deploy – запуск деплоев и рестарт существующих ресурсов без права их изменения;
- read – только чтение информации о ресурсах и их состоянии;
- read:sensitive – чтение чувствительных данных, таких как значения переменных окружения и секретов.
- Нажмите «Create» и сохраните сгенерированный токен в надежное место – после закрытия окна он больше не отобразится.
Передайте AI-агенту или внешнему скрипту следующие данные:
- адрес панели Coolify, например,
https://my-domain.beget.app; - сгенерированный API-токен в заголовке
Authorization: Bearer <token>.
После этого агент сможет через API создавать приложения из Git-репозитория, привязывать домены, задавать переменные окружения, запускать и останавливать деплои. Документация API доступна по адресу https://my-domain.beget.app/docs/api (Swagger UI открывается прямо в вашем инстансе Coolify) и на сайте Coolify: https://coolify.io/docs/api-reference.
