Создание и управление сайтами

Сайты создаются с главного экрана кнопкой Создать сайт. Окружение должно быть запущено для режимов «Под ключ» и «Из бэкапа». Кнопка «Создать сайт» неактивна, пока не поднялись все три службы (Nginx + PHP + MySQL) — дождитесь полного запуска окружения.

Имя и домен

Введите короткое имя латиницей, цифрами, дефисом или подчёркиванием (a–z, 0–9, -, _), например shop или wiz_start. Сайт откроется по адресу http://shop.bitrix (или с запасным портом, если 80 занят).

Папка по умолчанию: ~/Omut/shop.bitrix/ (корень сайта). Веб-корень новых сайтов — подкаталог www/ (~/Omut/shop.bitrix/www/: сюда попадают bitrixsetup.php, restore.php и файлы Битрикса). Зависимости Composer/npm (composer.json, vendor/, node_modules/) живут в корне сайта, вне web. Старые сайты без www/ продолжают работать как раньше. Если в настройках заданы несколько корней сайтов — новый сайт создаётся в основном корне (см. Настройки → Пути данных).

Можно указать свою папку при создании или копии: выберите каталог на диске — он станет корнем сайта. Имя папки может быть любым (не обязательно имя.bitrix); адрес в браузере по-прежнему имя.bitrix. Непустую папку Omut привязывает как есть, без затирания файлов. Корни из Настроек при этом не меняются — они нужны только для сканирования списка сайтов.

Встроенный терминал открывается из карточки сайта (cwd = корень сайта; на Windows — ConPTY). Клик по пути к папке открывает её в Finder (macOS), Проводнике (Windows) или файловом менеджере (Linux).

На Free — до 3 сайтов. На Pro — без лимита. Уже созданные сайты продолжают работать даже при превышении лимита Free — ограничение только на создание новых.

Версии PHP и MySQL

При создании выбираются PHP и MySQL. По умолчанию берутся значения из Настройки.

• Free: одна версия PHP для всех сайтов (глобальная настройка).
• Pro: своя версия PHP на каждый сайт.
• Free: только MySQL 8.4.
• Pro: MySQL 8.4, 8.0, 5.7 и 5.6 (5.x на Apple Silicon — через Rosetta 2).

Способы установки

Мастер в браузере

Классический путь: Omut скачивает bitrixsetup.php в папку сайта и открывает мастер установки в браузере.

1. Выберите Мастер в браузере.
2. Укажите имя, PHP, MySQL.
3. После создания откройте http://имя.bitrix и пройдите установщик Битрикса.

В окне создания показан блок готовых кредов БД с кнопкой копирования: хост localhost, имя базы, логин и пароль bitrix / bitrix. Вставьте их в мастер установки Битрикса — сокет MySQL подхватывается автоматически.

Под ключ

Omut сам скачает дистрибутив, создаст БД и установит Битрикс.

1. Выберите Под ключ.
2. Укажите редакцию. В списке две группы:
   • Управление сайтом — Старт, Стандарт, Малый бизнес, Бизнес;
   • Битрикс24 — Компания, Интернет-магазин + CRM, Энтерпрайз.
3. При желании задайте свой пароль администратора (пусто = дефолт OmutAdmin1!).
4. Дождитесь завершения — откроется модалка с логином и паролем админки. Позже их можно посмотреть или сменить: ⋮ → Доступ администратора.

Для Битрикс24 установка включает мастер портала и подготовку CRM. Чат и уведомления в реальном времени работают, если включены Redis и Push & Pull — см. Битрикс24 локально.

Доступно в Free и Pro.

Обновления Битрикса. При «под ключ» Omut запрашивает пробный ключ у сервера 1С-Битрикс (шаг регистрации продукта мастера; нужен интернет). Локально ключ не генерируется и маркер DEMO не пишется. Онлайн — обновления обычно доступны сразу; офлайн — установка не падает, ключ можно ввести позже в админке: Настройки → Обновление системы.

Из бэкапа (restore.php)

Восстановление с архивов Битрикса:

1. Выберите Из бэкапа.
2. Укажите архивы сразу или положите их позже в веб-корень сайта (www/ у новых сайтов; у старых — корень имя.bitrix/).
3. Omut скачает restore.php в веб-корень, предсоздаст БД omut_<имя> (креды bitrix / bitrix), запишет stub .settings.php и dbconn.php с этими кредами (без перезаписи существующих файлов) и откроет мастер восстановления — форма БД будет предзаполнена.

До завершения restore сайт не считается установленным (нужны и .settings.php, и модуль main). На Free — только MySQL 8.4. Если бэкап с другой версии СУБД, восстановление может не пройти.

Карточка сайта

После создания на главном экране отображается карточка с:

• URL (HTTP/HTTPS)
• путём к папке
• переключателем HTTPS
• версиями PHP и MySQL
• бейджем версии Битрикса (модуль main) — если версия читается
• бейджем попугаев (perfmon) после замера
• стрелками слева на карточке — порядок сайтов в списке (сохраняется между запусками)
• кнопкой Терминал — консоль с php, Composer и Node
• кнопкой Копии базы

Кнопка ⋮ открывает панель действий сайта сбоку. В ней собраны: админка (с автовходом) и Adminer, импорт дампа базы, доступ администратора, копия площадки, переключатель роутинга, кастомизация nginx, очистка кэша, debug-режим и агенты на cron.

Порядок на главной не влияет на лимит Free (считается по дате создания сайтов, не по позиции в списке).

Nginx: роутинг и доп. директивы

В панели действий сайта (окружение должно быть запущено):

• Новый роутинг Битрикс — тумблер. Для сайтов, созданных в режимах Мастер в браузере и Под ключ, по умолчанию включён современный front controller routing_index.php; для Из бэкапа — urlrewrite.php (совместимость со старыми архивами). Переключатель всегда можно сменить вручную. При необходимости настройте routing в .settings.php и маршруты в /local/routes — Omut сам settings не меняет.
• Кастомизация nginx — текстовый блок только с директивами внутри server (без server {} / http {}). Файл хранится рядом с сайтом в имя.bitrix/omut/nginx.locations.conf, не в веб-корне. Перед применением Omut проверяет конфиг (nginx -t); при ошибке прежний конфиг остаётся, в интерфейсе — сообщение с деталями.

Шаблоны Битрикса вроде /bitrix/templates/.default/ и /local/templates/.default/ доступны по HTTP. Скрытые служебные пути (.git, .env, .settings.php, .htaccess и т.п.) по-прежнему закрыты.

Клонирование сайта

Создать копию площадки в панели действий (⋮) — копия файлов и базы на новое имя (новый.bitrix). Каталоги vendor/ и node_modules/ не копируются; служебная папка omut/ (в т.ч. nginx-snippet) — копируется. Если у копии есть composer.json, Omut сам выполнит composer install (нужен интернет / доступ к Packagist или зеркалу) и допишет секцию Composer в .settings.php. Ошибка install отменяет клон (файлы и БД копии откатываются). Учтите: composer install может выполнить скрипты и плагины из composer.json исходника — как при ручном запуске в терминале. npm install после клона не запускается. В дампе подменяются домены старого сайта. Окружение должно быть запущено; Битрикс на исходной площадке — установлен.

Удаление сайта

Кнопка корзины на карточке. Можно выбрать, что удалить:

• папку сайта на диске;
• дампы БД этого сайта;
• саму базу MySQL.

Либо открепить сайт от списка Omut, оставив файлы и базу на месте — сайт пропадёт из приложения, но не с диска.

Если MySQL в момент удаления недоступен, выбранные файлы и дампы всё равно обрабатываются — приложение предупредит, что DROP базы не выполнен.

Что дальше

• Инструменты Битрикса
• База данных
• HTTPS