> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.lumiweb.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Coolify — свой PaaS

> Деплой приложений, БД и Docker из Git с авто-SSL

Coolify — self-hosted платформа для деплоя, свой Heroku/Vercel на твоём сервере: приложения из Git, базы данных и Docker-сервисы поднимаются через веб-интерфейс, с автоматическим reverse-proxy и SSL. Платишь только за VPS, без вендор-лока и помесячной платы за облако.

<Note>
  Команды и числа сверены с официальной документацией [coolify.io/docs](https://coolify.io/docs) на момент написания — установщик и требования обновляются, перед установкой загляни туда.
</Note>

## Что понадобится

Сервер Lumi с **Ubuntu 22.04** (дефолтный образ) и от 2 ГБ RAM — комфортно от 4 ГБ (тариф VPS-2 и выше). IP, логин `root` и пароль возьми из карточки сервера в боте [@lumivps\_bot](https://t.me/lumivps_bot).

<Warning>
  Docker ставить заранее **не нужно** — установщик поднимет его сам. Если на сервере уже стоит Docker из **snap** — удали его, эта версия не поддерживается. И освободи порты 80/443/8000, если на них висит nginx, Apache или другая панель.
</Warning>

## Установка

<Steps>
  <Step title="Подключись к серверу по SSH">
    ```bash theme={"system"}
    ssh root@IP_твоего_сервера
    ```
  </Step>

  <Step title="Запусти официальный установщик">
    Одна команда поставит Docker Engine, зависимости и весь стек Coolify в `/data/coolify`:

    ```bash theme={"system"}
    curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
    ```

    Занимает несколько минут. В конце скрипт выведет адрес дашборда.
  </Step>

  <Step title="Открой дашборд и создай админа">
    Перейди на `http://IP_сервера:8000` — откроется страница регистрации. Создай **первый аккаунт**: он становится владельцем инстанса.

    <Warning>
      Зарегистрируйся **сразу** после установки. Кто первым откроет страницу регистрации, тот и получит полный контроль над сервером — не тяни.
    </Warning>
  </Step>
</Steps>

## Открой порты в файрволе

Coolify использует несколько портов:

| Порт        | Зачем                              |
| ----------- | ---------------------------------- |
| 8000        | Дашборд Coolify                    |
| 80 / 443    | HTTP/HTTPS приложений и выпуск SSL |
| 6001 / 6002 | Realtime-обновления и веб-терминал |

```bash theme={"system"}
ufw allow 8000/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 6001/tcp
ufw allow 6002/tcp
```

<Warning>
  Coolify работает на Docker, а тот через свои iptables-правила умеет **обходить ufw** — порт может остаться открытым, даже если ufw его «не пускает». Для надёжной фильтрации используй **файрвол провайдера** (на стороне облака) или настрой связку `ufw-docker`. Подробнее про ufw — [Файрвол](/vps/firewall).
</Warning>

## Домен и SSL

По умолчанию дашборд работает по IP и HTTP. Чтобы повесить его на домен с HTTPS:

<Steps>
  <Step title="Направь домен на сервер">
    Создай **A-запись** (например `coolify.твойдомен.ru` → IP сервера). Как — [DNS-записи](/domains/dns).
  </Step>

  <Step title="Пропиши домен в Coolify">
    В дашборде: **Settings → Configuration** → поле **Instance's Domain (FQDN)** → впиши адрес **с `https://`**: `https://coolify.твойдомен.ru` → **Save**.
  </Step>

  <Step title="SSL выпустится сам">
    Coolify настроит встроенный reverse-proxy (Traefik) и автоматически получит сертификат Let's Encrypt. Продление — тоже автоматическое, делать ничего не нужно.
  </Step>
</Steps>

<Tip>
  Тот же принцип работает для приложений: при создании ресурса указываешь его домен с `https://`, и Coolify сам выпускает под него сертификат.
</Tip>

## Первый деплой

<Steps>
  <Step title="Сервер уже подключён">
    `localhost` (сам этот сервер) Coolify добавляет автоматически при установке — отдельно подключать не надо.
  </Step>

  <Step title="Создай проект">
    **+ New** → **Project**, внутри — окружение (Production по умолчанию).
  </Step>

  <Step title="Добавь ресурс">
    **+ New Resource** → выбери источник: публичный или приватный **Git-репозиторий**, готовый **Docker-образ** или **Docker Compose**. Coolify сам соберёт и запустит.
  </Step>

  <Step title="Укажи домен и задеплой">
    Впиши домен приложения с `https://` (SSL выпустится сам) → **Deploy**. Дальше каждый пуш в репозиторий деплоится кнопкой или автоматически по вебхуку.
  </Step>
</Steps>

## Подводные камни

<AccordionGroup>
  <Accordion title="Мало RAM — падает при сборке" icon="memory">
    На 1 ГБ Coolify нестабилен. Держи минимум 2 ГБ под сам Coolify плюс запас под приложения (комфортно — от 4 ГБ, тариф VPS-2 и выше).
  </Accordion>

  <Accordion title="Порт 80/443/8000 уже занят" icon="plug-circle-xmark">
    Если на сервере уже работает nginx, Apache или другая панель — прокси Coolify не стартует. Останови или удали их (или вынеси на другой порт) перед установкой.
  </Accordion>

  <Accordion title="ufw не закрывает порты" icon="shield-halved">
    Docker обходит ufw — см. блок про файрвол выше. Используй файрвол провайдера или `ufw-docker`.
  </Accordion>

  <Accordion title="Docker из snap" icon="box">
    Не поддерживается. Удали snap-версию Docker до установки — Coolify поставит свою.
  </Accordion>
</AccordionGroup>

Lumi отвечает за сервер и сеть; настройку софта делаешь ты. Сеть или порт не работают — пиши в [@lumisup\_robot](https://t.me/lumisup_robot).

## Куда дальше

<CardGroup cols={2}>
  <Card title="Docker" icon="box" href="/vps/docker">
    Coolify работает на Docker — как он устроен.
  </Card>

  <Card title="Свой домен" icon="globe" href="/domains/connect">
    Привязать домен к приложениям в Coolify.
  </Card>
</CardGroup>