1. Что такое Coolify и зачем он нужен
Vercel и Heroku удобны: пушнул в GitHub — сайт задеплоился сам. Но за это удобство платишь — буквально. Vercel берёт $20+/месяц за функции, которые нужны в продакшене. Heroku после отмены бесплатного тарифа стал ещё дороже. Coolify решает это просто: запускаешь его на своём VPS и получаешь тот же опыт, но за деньги VPS — то есть за 200–400 рублей в месяц вместо $20.
⚡ Автодеплой из Git
Push в репозиторий — Coolify собирает и деплоит автоматически. Поддерживает GitHub, GitLab, Gitea, Bitbucket.
🔒 SSL по умолчанию
Traefik как reverse proxy + Let's Encrypt. Добавил домен — сертификат выпускается автоматически.
📦 280+ сервисов
PostgreSQL, MySQL, Redis, MongoDB, Nextcloud, Gitea, WordPress, n8n, Ghost — всё одним кликом.
🖥️ Несколько серверов
Один интерфейс — любое количество VPS. Деплой на разные серверы из одной панели.
🔍 Логи и мониторинг
Логи контейнеров в реальном времени прямо в браузере. CPU, RAM и сеть — по каждому сервису.
🔄 Preview deployments
Автодеплой для каждого PR. Удаляется вместе с PR — как у Vercel, но на своём железе.
💾 Бэкапы баз данных
Автоматические бэкапы в S3-совместимое хранилище по расписанию. Восстановление одной кнопкой.
🆓 Полностью бесплатно
Apache 2.0, self-hosted. Никаких ограничений на количество проектов, пользователей или деплоев.
Coolify v4 в активной разработке
Проект быстро развивается: релизы выходят несколько раз в месяц. Для продакшена — делайте резервные копии баз данных. Читайте release notes перед обновлением.
2. Требования к серверу
| Параметр | Минимум | Для реальных задач |
|---|---|---|
| CPU | 2 vCPU | 2–4 vCPU |
| RAM | 2 ГБ | 4 ГБ (при нескольких сервисах) |
| Диск | 30 ГБ SSD | 40–80 ГБ SSD |
| ОС | Ubuntu 20.04 / 22.04 / 24.04 LTS | Ubuntu 22.04 LTS |
| Docker | Устанавливает сам | Engine v24+ |
Важно про Ubuntu
Скрипт автоустановки поддерживает только Ubuntu LTS (20.04, 22.04, 24.04). Non-LTS версии (например, 24.10) не поддерживаются — используйте 22.04. Для Debian и других дистрибутивов есть ручная установка через документацию.
3. Установка одной командой
Вся установка — один curl. Скрипт сам поставит Docker, настроит Traefik, создаст базу данных Coolify и запустит все сервисы. Занимает 2–5 минут.
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bashЧто делает скрипт:
http://IP_СЕРВЕРА:8000Если порт 8000 занят
Задайте переменную перед запуском скрипта: export APP_PORT=9000. Или отредактируйте /data/coolify/.env после установки и перезапустите: cd /data/coolify && docker compose up -d.
4. Первоначальная настройка
Откройте http://IP_СЕРВЕРА:8000. Первый пользователь, который зарегистрируется, становится администратором.
- 1Заполните форму регистрации: email + пароль. Никакого подтверждения на почту — аккаунт создаётся сразу.
- 2Нажмите «Get Started» для запуска мастера настройки.
- 3В шаге «Server» выберите Localhost — это Docker-демон на текущем сервере. Coolify проверит соединение и покажет статус «Reachable».
- 4В шаге «Project» создайте первый проект: задайте имя (например, my-apps). Coolify автоматически создаст окружение production.
- 5Нажмите «Finish» — попадёте на главный дашборд.
Ключевые понятия Coolify
- Server — физический или виртуальный сервер, куда деплоятся приложения
- Project — логическая группа приложений (например, «Стартап», «Pet-проект»)
- Environment — окружение внутри проекта: production, staging, dev
- Resource — конкретное приложение, база данных или сервис в окружении
5. Деплой первого приложения из GitHub
Разберём деплой на примере публичного GitHub-репозитория. Для приватных репозиториев нужно настроить GitHub App или Personal Access Token — Coolify проведёт через этот процесс в интерфейсе.
Добавить GitHub-источник
- 1В левом меню откройте Sources → Add → выберите GitHub App (для приватных репо) или GitHub Public (для публичных).
- 2Для GitHub App нажмите Register GitHub App — Coolify перенаправит на GitHub, где нужно разрешить доступ к нужным репозиториям.
- 3После авторизации Coolify сохранит токен — можно подключать репозитории.
Создать приложение
- 1Перейдите в свой проект → Add Resource → Application.
- 2Выберите источник: GitHub, GitLab, Gitea или просто Public Git Repository (по URL).
- 3Укажите репозиторий и ветку (обычно
main). - 4Выберите Build Pack. Для большинства Node.js / Python / Go проектов выберите Nixpacks — он автоматически определит язык и установит зависимости.
- 5Укажите порт приложения в поле Port Exposes (например,
3000для Node.js). - 6Нажмите Save, затем Deploy. Откройте вкладку Deployments — логи сборки в реальном времени.
Nixpacks
Авто-определение: Node, Python, Go, Ruby, PHP, Rust. Рекомендуется для большинства проектов.
Dockerfile
Использует ваш Dockerfile. Полный контроль над образом. Подходит для специфичных конфигураций.
Docker Image
Деплой готового образа из Docker Hub или любого registry. Самый быстрый вариант.
6. Автодеплой через GitHub webhook
Главная магия Coolify: пушнул код — сервер сам подтянул изменения, собрал и задеплоил без единой команды. Настройка занимает 3 минуты.
В интерфейсе Coolify
- 1Откройте своё приложение → вкладка General → прокрутите до секции Webhook.
- 2Включите переключатель Auto Deploy.
- 3Скопируйте Webhook URL — он вида
https://ваш-coolify.ru/webhooks/source/github/events/... - 4Создайте Webhook Secret — любая случайная строка, например из
openssl rand -hex 32. Сохраните в поле Coolify.
В настройках GitHub-репозитория
- 1Откройте репозиторий → Settings → Webhooks → Add webhook.
- 2В поле Payload URL вставьте скопированный URL из Coolify.
- 3В поле Secret вставьте Webhook Secret.
- 4Content type:
application/json. SSL verification: Enable. - 5Выберите событие Just the push event. Нажмите Add webhook.
openssl rand -hex 32
# Пример: a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1Теперь при каждом git push GitHub отправит запрос в Coolify, и деплой запустится автоматически. В разделе Deployments вашего приложения увидите историю всех деплоев.
7. PostgreSQL одним кликом
Coolify умеет разворачивать базы данных так же просто, как приложения. Не нужно писать docker-compose.yml вручную.
- 1В вашем проекте нажмите Add Resource → Databases → PostgreSQL.
- 2Coolify заполнит дефолты: пользователь
postgres, случайный пароль, базаpostgres. Можно поменять или оставить как есть. - 3Выберите версию PostgreSQL (16 — актуальная LTS) и нажмите Save.
- 4Нажмите Start — Coolify запустит контейнер.
- 5В разделе Connection скопируйте готовый Connection String — он вида
postgresql://postgres:password@localhost:5432/postgres.
Базы данных в Coolify
Автобэкапы в S3
В настройках базы данных → Backups → подключите S3-совместимое хранилище (AWS S3, Cloudflare R2, Minio, Selectel S3). Coolify будет делать pg_dump по расписанию и загружать в бакет. Восстановление — кнопкой в интерфейсе.
8. Деплой Next.js приложения
Next.js — один из самых распространённых стеков. Coolify деплоит его без Dockerfile через Nixpacks: автоматически определяет Node.js, устанавливает зависимости и запускает next start.
- 1Добавьте ресурс: Add Resource → Application → выберите GitHub-репозиторий с Next.js.
- 2Build Pack: Nixpacks. Coolify автоматически определит Node.js проект.
- 3Port Exposes:
3000(стандартный порт Next.js). - 4Добавьте переменные окружения в секции Environment Variables: DATABASE_URL, API-ключи и т.д.
- 5Нажмите Deploy. Сборка займёт 2–5 минут при первом запуске.
Если нужен Dockerfile
Для полного контроля создайте Dockerfile в корне репозитория. Coolify найдёт его автоматически, если выбрать Build Pack → Dockerfile.
FROM node:20-alpine AS base
FROM base AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]output: standalone в next.config
Для multi-stage Dockerfile добавьте в next.config.js: output: 'standalone'. Это создаст минимальный standalone-сборку — образ будет в 5–10 раз меньше.
9. Домен и автоматический SSL
Coolify использует Traefik как reverse proxy — он автоматически получает Let's Encrypt-сертификат при привязке домена. Никакого Nginx настраивать не нужно.
Шаг 1: настройте DNS
Добавьте A-запись у вашего регистратора домена:
app.ваш-домен.ru → A → IP_СЕРВЕРАШаг 2: укажите домен в Coolify
- 1Откройте настройки приложения → поле Domains.
- 2Введите
https://app.ваш-домен.ru. Обязательно сhttps://— это сигнал Coolify получить SSL-сертификат. - 3Нажмите Save → Redeploy.
- 4Coolify через Traefik запросит сертификат у Let's Encrypt. Через 1–2 минуты сайт будет доступен по HTTPS.
Перенести Coolify на свой домен
Сам интерфейс Coolify тоже можно перевести с IP:8000 на красивый домен.
В левом меню: Settings → поле Instance's Domain → введите https://coolify.ваш-домен.ru → Save. Traefik автоматически выпустит сертификат, и Coolify переедет на этот адрес. Порт 8000 после этого можно закрыть в файрволе.
ufw delete allow 8000/tcp
ufw reload