Layers

Свой сервер

Layers на вашем сервере

Диск с правкой документов и таблиц в браузере, страницы, формы, проекты, чат, звонки, почта и календарь на вашей машине. Одна команда — меньше 3 минут до первого входа (замер на 2 ядрах и 4 ГБ).

Образ лежит на Docker Hub, входить в реестр не нужно.

14 дней на вашем сервере до 5 человек · без карты · без звонка

€5 за пользователя в месяц или €50 за пользователя в год

Закрытый контур: лицензия проверяется без интернета — в любом тарифе.

Установить Полная инструкция Купить ключ Написать нам

Версия 3.0.1 · 14.11.2026 · Docker Hub
Обновление — та же команда: запустите её ещё раз.

60 секунд из 4:17, ускорено: чистая Ubuntu 22.04, 2 ядра и 4 ГБ, команда из письма с пробным ключом, вход владельца, двое коллег по одной ссылке. От команды до «лицензия активна» — 2 мин 57 с.

Сравнить с Nextcloud, ONLYOFFICE и другими →

Установка целиком, без вырезов и ускорения

Что ставится

Восемь служб, один файл

Всё описано в одном docker-compose.yml, менять в нём ничего не нужно. Ваши настройки лежат рядом, в файле .env, — его создаёт шаг 3.

Layers

hissih/layers:3.0.1

Само приложение: пространства, API, файлы. Этот же образ готовит базу при первом запуске.

PostgreSQL

pgvector/pgvector:pg16

База данных. Её файлы остаются в /opt/layers/data на вашем сервере.

Redis

redis:7-alpine

Быстрое хранилище для сессий и очередей.

LiveKit

TCP 7881 · UDP 7882 · UDP 3478

Звонки и показ экрана. Встроенный TURN-сервер принимает звонки из офисных сетей, где открыт только порт 443.

Caddy

TCP 80 · UDP 443

Веб-сервер. Сам получает и продлевает сертификаты HTTPS.

entry443

TCP 443

Вход на порту 443: сайт отдаёт веб-серверу, звонки из закрытых сетей — серверу звонков, ничего не расшифровывая.

a4 · docx

hissih/sumdoc-webhost

Редактор документов .docx в браузере: Диск открывает в нём файлы, двое правят вместе. Портов наружу нет — только через веб-сервер.

f1 · xlsx

hissih/sumsheet-webhost

Редактор таблиц .xlsx в браузере, так же через Диск и веб-сервер. Файл берёт и сохраняет через Layers с правами того, кто открыл.

Linux x86-64 и Docker

Проверено на Ubuntu 22.04 и 24.04; подойдёт Ubuntu 22.04+ или Debian 12+. Docker 24 или новее с docker compose — его ставит установщик или шаг 1.

Память: минимум 4 ГБ, рекомендуется 8 ГБ

С редакторами документов и таблиц минимум — 4 ГБ: на 4 ГБ — правка вдвоём и 2–4 открытых файла; для команды — 8 ГБ. Проверено 15.11 на чистой машине из 2 ядер и 4 ГБ: после правки документа и таблицы вдвоём все службы в покое занимают около 2,2 ГБ (Layers — 1,4 ГБ, редактор таблиц — 320 МБ, редактор документов — 190 МБ, база — 220 МБ). Сколько документов открыто в редакторах одновременно, задаёт строка EDITOR_MAX_DOCS в .env (по умолчанию 6); на машине меньше 4 ГБ установщик сам пишет EDITOR_MAX_DOCS=2. Самой службе Layers нужно не меньше 1,5 ГБ: с 1 ГБ она не поднимается — команда запуска ждёт около семи минут и отвечает «unhealthy».

Диск: 25 ГБ, 2 ядра

Первая загрузка — около 1,7 ГБ: восемь образов с Docker Hub вместе с редакторами. На диске они занимают 4,3 ГБ, из них редакторы — 1,8 ГБ. Сразу после запуска на чистой Ubuntu 22.04 занято около 6 ГБ диска вместе с системой; дальше растут база и файлы людей.

Два имени и пять портов

Две записи A на сервер: layers.example.com и turn.layers.example.com. Открытые порты 80 и 443 (TCP и UDP); для звонков — ещё TCP 7881, UDP 7882 и UDP 3478. Если открыть можно только 80 и 443, звонки всё равно работают — через 443.

Способ 1 — одной командой

Команда из письма с ключом

В письме с ключом (пробным или оплаченным) — готовая строка установки с вашим ключом и id установки. Выполните её на сервере с Ubuntu 22.04+ или Debian 12+: установщик проверит машину, предложит поставить Docker, спросит адрес, запишет .env, положит ключ и запустит сервер — около 3 минут. Ключ можно заранее проверить, ничего не меняя на машине. Хотите видеть каждую команду — способ 2, шаги ниже.

Установка
curl -fsSL https://layers.md/self-hosted/install.sh | sh -s -- --key ключ-из-письма --instance ent-…
Проверить ключ, ничего не ставя
curl -fsSL https://layers.md/self-hosted/install.sh | sh -s -- --check-key ключ-из-письма

Установка

Способ 2 — по шагам, от пустого сервера до работающего

Все команды здесь, придумывать ничего не нужно. Пароли и ключи создаёт шаг 3. Замените layers.example.com на своё имя.

  1. 1

    Поставьте Docker

    Около минуты. Если Docker 24 или новее с docker compose уже стоит, шаг пропускается.

    Терминал
    sudo apt-get update && sudo apt-get install -y docker.io docker-compose-v2
  2. 2

    Скачайте файл установки

    Создайте каталог и скачайте в него docker-compose.yml. Менять в файле ничего не нужно.

    Проверка: ls /opt/layers показывает docker-compose.yml.

    Терминал
    sudo mkdir -p /opt/layers && cd /opt/layers
    sudo curl -fsSLO https://layers.md/self-hosted/docker-compose.yml
  3. 3

    Запишите настройки

    Замените во второй строке layers.example.com на своё имя и выполните блок целиком. Он создаёт файл .env с вашим адресом и случайными паролями и отвечает одной строкой: Done: .env written for …. Если .env уже есть, блок его не трогает: это ключи работающего сервера.

    Если письмо с ключом уже пришло, допишите в .env две его строки, как во втором окне: LICENSE_KEY= — ключ одной строкой, LAYERS_INSTANCE_ID= — id установки из письма (вида ent-…). Без id установки сервер не примет ключ как свой. Ключа ещё нет — пропустите, его можно поставить позже (шаг 8). Сохраните копию .env в надёжном месте — без него не восстановить сервер из резервной копии.

    Терминал
    cd /opt/layers
    DOMAIN=layers.example.com
    if sudo test -e .env; then echo ".env already exists - the server is set up, skip this step"; else
    sudo tee .env >/dev/null <<EOF
    DOMAIN=$DOMAIN
    DB_PASSWORD=$(openssl rand -hex 16)
    REDIS_PASSWORD=$(openssl rand -hex 16)
    APP_JWTSECRET=$(openssl rand -hex 32)
    AUDIT_SECRET=$(openssl rand -hex 32)
    SECRETCHATS_SERVER_ID=$(cat /proc/sys/kernel/random/uuid)
    LIVEKIT_API_KEY=lk$(openssl rand -hex 6)
    LIVEKIT_API_SECRET=$(openssl rand -hex 24)
    ADMIN_PASSWORD=$(openssl rand -hex 16)
    EOF
    sudo chmod 600 .env; echo "Done: .env written for $DOMAIN"; fi
    Две строки из письма — если ключ уже есть
    cd /opt/layers
    echo "LICENSE_KEY=ключ-из-письма" | sudo tee -a .env >/dev/null
    echo "LAYERS_INSTANCE_ID=ent-…" | sudo tee -a .env >/dev/null
  4. 4

    Запустите

    Команда скачивает образы с Docker Hub (около 1,7 ГБ; на диске — 4,3 ГБ, из них Layers, hissih/layers:3.0.1, — 1,5 ГБ), запускает базу данных, Layers, сервер звонков, редакторы документов и таблиц и веб-сервер, готовит базу и возвращает управление, когда всё поднялось. На чистой машине (2 ядра, 4 ГБ) установщик с редакторами вместе со скачиванием занял 160 секунд.

    Терминал
    cd /opt/layers && sudo docker compose up -d
  5. 5

    Проверьте

    Должно быть: layers — healthy, prepare и migrate — Exited (0). Последняя строка — одна из двух, обе означают «база готова»: migrate: the server keeps the database up to date itself …, nothing to do или migrate: mode=fresh, applied ….

    Пока migrate ещё Up, подождите минуту и повторите проверку. После перезагрузки машины Layers поднимается сам, через одну-две минуты.

    Терминал
    sudo docker compose ps -a
    sudo docker compose logs migrate | tail -1
  6. 6

    Войдите в первый раз

    Откройте https://ваше-имя/register, введите почту и пароль, нажмите «Зарегистрироваться». Вы попадаете в своё рабочее пространство и вы в нём владелец. «Общение» → «Избранное» — первое сообщение можно отправить тут же.

    Подтверждение почты не требуется: пока почта не настроена, сервер писем просто не шлёт.

    Браузер
    https://layers.example.com/register
  7. 7

    Позовите коллег

    «Пригласить» → «По ссылке» → «Ссылка для всей команды» — одна ссылка для всей команды: отправьте её в общий чат. Входов по ней — столько, сколько свободных мест в ключе (в пробный срок — до 5 человек); когда входы кончатся, ссылка перестанет работать («Ссылка уже использована»); купили места — создайте новую. Отозвать ссылку — одной кнопкой там же или в «Настройки → Ссылки-приглашения». Нужна ссылка на одного человека — «Создать ссылку»: по умолчанию она на 1 вход и действует сутки.

    Коллега открывает ссылку, вводит почту и пароль — и сразу оказывается в вашем пространстве. Если внизу слева висит окно «Включить уведомления?», сначала закройте его («Не сейчас»): кнопка «Пригласить» под ним.

    Кто зарегистрируется сам по адресу /register, попадёт не к вам, а в отдельное пустое пространство — и займёт одно из мест на сервере.

  8. 8

    Пробный срок — и ключ, когда решите

    Без ключа сервер работает пробный срок: 14 дней, до 5 человек. Остаток и правила отвечает сам сервер — спросите его, как справа.

    Ключ приходит письмом файлом license.jws; он же — строка после --key в команде из письма и в кабинете (ссылка на кабинет — в том же письме). Положите файл в /opt/layers/license/ под этим именем — сервер подхватит его в течение минуты, без перезапуска. Можно и вставить ключ в God Mode → «Лицензия». Сервер с интернетом сам подтягивает продлённый ключ и докупленные места.

    Проверяйте node.regime, а не mode: full — ключ действует, мест — maxUsers; есть keyProblem — ключ не для этой установки, текст скажет, что не так, пробный срок при этом не сгорает; read-only — срок ключа или пробный срок вышел: вход, просмотр и выгрузка работают, править нельзя, ничего не удаляется. На экране — полоса «Срок ключа закончился» с кнопкой «Продлить».

    Спросить сервер
    curl -s https://layers.example.com/layers/license/status
    # {"mode":"MISSING", …, "node":{"regime":"trial","trialDaysLeft":…,"maxUsers":…,"activeUsers":…,
    #   "rules":{"trialDays":…,"trialUsers":…,"renewWarningDays":…,"paymentGraceDays":…}}}
    Поставить ключ
    cd /opt/layers
    sudo cp ~/license.jws license/license.jws    # the file from the letter, named license.jws
    sleep 60                                     # picked up within a minute, no restart
    curl -s https://layers.example.com/layers/license/status | grep -o '"regime":"[a-z-]*"'
    # "regime":"full"

Если сервер ставили раньше

Смените пароль панели администратора

С 15.11.2026 установщик сам ставит случайный пароль панели администратора (God Mode, /godmode) и пишет его в /opt/layers/.env строкой ADMIN_PASSWORD (права 600); блок шага 3 делает то же. На серверах, поставленных раньше, панель пускает по admin / admin. Закрыть — одним из двух способов: ещё раз запустить команду установки из письма или выполнить команду ниже; пароль ляжет в .env. Проверено на чистой установке 3.0.1: после этого admin / admin получает отказ, и после перезапуска тоже; повторный запуск ничего не меняет.

Терминал
cd /opt/layers && P=$(openssl rand -hex 16) && T=$(sudo docker compose exec -T layers wget -qO- --post-data "username=admin&password=admin&bearer=true" http://localhost:8080/data/auth/admin/login | sed -n 's/.*"token":"\([^"]*\)".*/\1/p') && [ -n "$T" ] && sudo docker compose exec -T layers wget -qO- --header "Authorization: Bearer $T" --header "Content-Type: application/json" --post-data "{\"current\":\"admin\",\"next\":\"$P\"}" http://localhost:8080/data/auth/admin/password >/dev/null && echo "ADMIN_PASSWORD=$P" | sudo tee -a .env >/dev/null && echo "Done: God Mode password is in /opt/layers/.env (ADMIN_PASSWORD)"
Проверка — старый пароль больше не подходит
cd /opt/layers && sudo docker compose exec -T layers wget -qO- --post-data "username=admin&password=admin" http://localhost:8080/data/auth/admin/login >/dev/null 2>&1 && echo "NOT CLOSED: admin/admin still works" || echo "Closed: admin/admin is refused"

Панель администратора

God Mode — только из вашей сети

С 15.11.2026 панель администратора (God Mode, /godmode) и её API отвечают только локальным сетям (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) и самой машине; всем остальным — 403. Страницы для людей это не задевает. Нужен доступ снаружи — перечислите адреса или сети параметром --godmode-allow или строкой GODMODE_ALLOW в .env; открыть всем — "0.0.0.0/0 ::/0". Оставляйте в списке private_ranges: список заменяет умолчание, и без этого слова закроются локальная сеть и сама машина. Проверено на чистой установке 3.0.1: снаружи 403, из локальной сети — страница входа, повторный запуск список сохраняет.

Открыть панель для офиса снаружи — той же командой установки
curl -fsSL https://layers.md/self-hosted/install.sh | sh -s -- --godmode-allow "private_ranges 203.0.113.7"
Или строкой в .env (файл установки от 15.11.2026)
cd /opt/layers && sudo sed -i '/^GODMODE_ALLOW=/d' .env && echo "GODMODE_ALLOW=private_ranges 203.0.113.7" | sudo tee -a .env >/dev/null && sudo docker compose up -d
Проверка с машины не из списка
curl -s -o /dev/null -w "%{http_code}\n" https://layers.example.com/godmode
# 403

Домена пока нет

Посмотреть без своего домена

На машине с Docker — на самом сервере или на своём компьютере — во второй строке шага 3 напишите layers.localhost, остальное — как написано. Потом откройте адрес в браузере этой же машины: имена на .localhost ведут на саму машину, записи DNS не нужны. Сертификат выдаёт сам сервер, поэтому браузер о нём предупредит; с других компьютеров такой сервер не открыть. Для настоящей работы нужен домен.

Шаг 3, вторая строка
DOMAIN=layers.localhost
Браузер
https://layers.localhost/register

Лицензия

€5 за пользователя в месяц или €50 за пользователя в год

Пробный срок

14 дней

14 дней бесплатно, до 5 человек; следующий увидит, почему ему нельзя войти и где купить ключ. Срок вышел, ключа нет — сервер переходит в режим «только чтение»: вход и просмотр работают, правка и отправка закрыты, данные на месте.

Лицензия

€5 за пользователя в месяц

Или €50 за пользователя в год. Ключ — одна строка; число мест записано в ключе.

Получить ключ

Числа пробного срока — с сервера: каждый сервер отдаёт свои правила по адресу /layers/license/status. Установка, внедрение, доработки и поддержка — отдельно, по договорённости, платно.

Сравнение с Nextcloud, ONLYOFFICE, Mattermost и другими →Памятка для ИТ и службы безопасности →

Если что-то пошло не так

Что отвечает сервер и что делать

Каждый из этих ответов получен на проверочной машине. Журналы: sudo docker compose logs layers (сервер), caddy (HTTPS), livekit (звонки), migrate (база).

Что видноПричинаЧто сделать
required variable … is missing a valueНет файла .env или в нём не хватает строки.Выполнить шаг 3 в каталоге /opt/layers.
failed to bind host port 0.0.0.0:80/tcp: address already in useПорт 80 или 443 занят другим веб-сервером. Остальные службы уже работают.Остановить его и повторить команду запуска: поднимется только недостающая служба. Кто занял порт: sudo ss -ltnp 'sport = :80'
dial tcp …: i/o timeoutУ сервера нет выхода к Docker Hub.Вернуть сеть и повторить команду запуска: скачанное не теряется. Если сети не будет, образы переносятся файлом — раздел «Закрытая сеть».
container layers-layers-1 is unhealthy + java.lang.OutOfMemoryErrorНе хватает памяти. Команда запуска ждёт около семи минут, прежде чем ответить.Добавить память (с редакторами — минимум 4 ГБ, рекомендуется 8 ГБ) и повторить команду запуска. Люди и данные остаются.
container … is unhealthy + No space left on deviceНа диске нет места.Освободить место и повторить команду запуска.
password authentication failed for user "layers", 502Файл .env заменён новым: пароль базы в нём не тот, с которым база создана.Вернуть прежний .env из копии и запустить снова. Люди и данные остаются. Копии нет — пароль базы можно поставить заново, команда есть в полной инструкции.
"mode":"INVALID"Ключ из письма скопирован с ошибкой или не полностью. Пробный срок идёт как шёл.Положите заново файл license.jws из письма в /opt/layers/license/ (или исправьте строку LICENSE_KEY= в .env — одна строка, без пробелов и переносов).
"regime":"read-only"Срок ключа закончился (полоса «Срок ключа закончился») или ключ выпущен для другой установки (полоса «Ключ не подходит этому серверу», в ответе — keyProblem).«Продлить» — в кабинете по ссылке из письма: новый ключ выйдет на ту же установку, сервер подхватит его сам. Ключ чужой установки — возьмите в кабинете ключ этой.
Машину перезагрузили или она выключилась, даже посреди установкиНичего не сломано: службы поднимаются сами.Подождать одну-две минуты. Если прервана установка, повторить команду запуска — она доделает оставшееся.

Получено на стенде 13 ноября 2026. Истёкший ключ проверен только автотестами.

Закрытая сеть

Сервер без выхода в интернет: образы файлом

Скачайте образы и файл установки на машине с интернетом и перенесите одним файлом. Дальше шаги 3–8 как написано: команда запуска возьмёт образы с машины. Ключ проверяется на самом сервере, без интернета.

На машине с интернетом
curl -fsSLO https://layers.md/self-hosted/docker-compose.yml
for i in hissih/layers:3.0.1 pgvector/pgvector:pg16 redis:7-alpine livekit/livekit-server:v1.11 caddy:2-alpine nginx:alpine hissih/sumdoc-webhost:2026.11.03-amd64 hissih/sumsheet-webhost:2026.10.22-amd64; do sudo docker pull $i; done
sudo docker save hissih/layers:3.0.1 pgvector/pgvector:pg16 redis:7-alpine livekit/livekit-server:v1.11 caddy:2-alpine nginx:alpine hissih/sumdoc-webhost:2026.11.03-amd64 hissih/sumsheet-webhost:2026.10.22-amd64 | gzip > layers-images.tar.gz
На сервере, вместо скачивания в шаге 2
sudo mkdir -p /opt/layers && sudo cp docker-compose.yml /opt/layers/
gunzip -c layers-images.tar.gz | sudo docker load

С секундомером

Проход на чистой машине

13 ноября 2026 мы прошли эти шаги на новой пустой Ubuntu 24.04, делая только то, что написано. От первой команды до первого входа администратора ушло около четырёх минут.

ШагВремя от первой команды
Поставьте Docker00:00–00:52
Скачайте файл установки00:52
Запишите настройки00:52–00:53
Запустите01:14–03:29
Проверьте03:30
Войдите в первый разещё около 15 секунд

На этом проходе образы уже лежали на машине; скачивание с Docker Hub добавит столько, сколько ваша сеть качает 1,7 ГБ.

Установка с ИИ

Поставьте вместе с ИИ‑ассистентом

Скопируйте промпт в ChatGPT, Claude или любой другой ассистент. Он прочитает полную инструкцию и проведёт по тем же восьми шагам.

Инструкция для ИИ и людей: layers.md/self-hosted/llms.ru.txt

Промпт
Помоги установить Layers на мой сервер. Инструкция: https://layers.md/self-hosted/llms.ru.txt (полная — https://layers.md/self-hosted/llms-full.ru.txt). Веди меня по шагам и сначала спроси про домен.

Почему так

Что даёт свой сервер

Данные у вас

База, файлы людей и ключи лежат в /opt/layers на вашей машине.

Ключ проверяется на сервере

Сервер лицензий и выход в интернет для этого не нужны: ключ сверяется на месте.

HTTPS сам

Сертификаты выпускаются при первом запуске и продлеваются без вас.

Звонки из закрытых сетей

Встроенный TURN-сервер принимает звонок на порту 443 — том же, что и сайт.

Закрытая сеть

Образы переносятся одним файлом; выход наружу серверу не нужен.

Переживает перезагрузку

После перезагрузки или отключения питания службы поднимаются сами.

Вопросы? Ответим за 1 рабочий деньВопросы?

Частые вопросы

Нужен ли серверу интернет?

Только чтобы скачать образы и получить сертификат HTTPS. В закрытой сети образы переносятся файлом, а ключ проверяется на самом сервере.

Сколько нужно железа?

Linux x86-64, 2 ядра, минимум 4 ГБ памяти (рекомендуется 8 ГБ) и 25 ГБ диска. На 4 ГБ — правка вдвоём и 2–4 открытых файла; для команды — 8 ГБ. Первая загрузка — около 1,7 ГБ. На 2 ядрах и 4 ГБ после правки в редакторах службы в покое занимают около 2,2 ГБ памяти; сразу после запуска на диске занято около 6 ГБ вместе с системой.

Как включить почту?

Допишите в .env данные своего ящика — MAIL_PROVIDER=smtp, MAIL_HOST, MAIL_PORT, MAIL_USER, MAIL_PASSWORD, MAIL_FROM — и выполните sudo docker compose up -d. Без этих строк Layers работает, но писем не шлёт.

Как обновляться?

Той же командой установки: запустите её ещё раз. Она скачает свежий docker-compose.yml и образы текущей версии и применит новые изменения базы; .env, база и файлы в /opt/layers остаются. Перед обновлением снимите копию базы. Если в .env версия закреплена строкой LAYERS_IMAGE=…, уберите её или впишите новую — иначе останется закреплённая.

Как делать резервные копии?

База: sudo docker compose exec -T db pg_dump -U layers -d layersdb -Fc -Z6 | sudo tee backup.dump >/dev/null. Файлы людей: каталог /opt/layers/data/layers. Ключи: файл .env и каталог /opt/layers/license.

Звонок соединяется, но нет звука и видео

Сервер звонков не узнал свой внешний адрес. Допишите в .env строку NODE_IP=203.0.113.10 (ваш внешний адрес) и выполните sudo docker compose up -d.

Что будет без ключа после 14 дней?

Сервер перейдёт в режим «только чтение»: вход, просмотр и выгрузка работают, создавать, править и отправлять нельзя. Данные на месте, ничего не удаляется и не замедляется. С ключом всё снова работает полностью.

Что не входит в эту установку?

Запись встреч в эту установку не входит. Секретные чаты выключены; включаются строкой SECRET_CHATS=true в .env. Вход через SAML, LDAP и SCIM не поддерживается.

Можно вместе править документы и таблицы?

Да. Документ .docx и таблица .xlsx с Диска открываются в браузере, а в «Создать» на Диске есть «Документ» и «Таблица». Двое правят один файл одновременно: в документе второму предлагают присоединиться к правке, и каждый видит текст другого с подписанным курсором; в таблице каждый видит ячейки, которые меняет другой. После закрытия и нового открытия обе правки на месте. Коллега открывает файл, которым с ним поделились на Диске. Редакторы — отдельные службы a4 (документы) и f1 (таблицы) в том же docker-compose.yml. Если редактор остановлен или ещё запускается, открывается страница «Редактор документов запускается» на языке браузера, и документ открывается сам, когда редактор готов; файл на Диске не меняется. Проверено 15.11 вдвоём на чистой установке Layers 3.0.1.

Соберите работу команды в Layers

Начните бесплатно в облаке — до 5 человек без срока — или разверните Layers на своём сервере.