Переезд на Omut
Миграция с OSPanel или Docker.
Краткий гайд для разработчиков с OSPanel или Docker.
Общая схема
- Установите Omut.
- Скопируйте файлы проекта в
~/Omut/имя-сайта.bitrix/(корень — где лежит/bitrix/). - Импортируйте дамп БД: меню сайта (⋮) → Импорт дампа базы (или разверните бэкап через restore.php).
- Проверьте
.settings.php/dbconn.php— хостlocalhost, сокет MySQL подхватывается автоматически.
С OSPanel / OpenServer
| OSPanel | Omut |
|---|---|
domains/ | ~/Omut/имя.bitrix/ |
| MySQL в панели | MySQL 8.4 по умолчанию |
.local домены | имя.bitrix |
| phpMyAdmin | Adminer из меню сайта |
| Импорт дампа в phpMyAdmin | Импорт дампа базы — напрямую в MySQL, мимо PHP |
Шаги:
- Остановите OSPanel (освободите порты 80/443/3306).
- Скопируйте папку сайта.
- Сделайте
mysqldumpв OSPanel и залейте файл через Импорт дампа базы. - В
.settings.php— хостlocalhost, пользовательroot, пароль пустой (или креды вашей dev-БД).
С Docker
docker compose down— освободите порты.- Скопируйте volume с файлами в
~/Omut/. - Экспорт:
docker exec … mysqldump … > dump.sql, дальше Импорт дампа базы в меню сайта. - Замените хосты
mysql/dbв.settings.phpнаlocalhost.
Omut быстрее Docker на Apple Silicon — нативные процессы без виртуализации.
Импорт дампа
Меню сайта (⋮) → Импорт дампа базы. Файл .sql или .sql.gz уходит прямо в MySQL,
минуя PHP: дамп не читается в память целиком, поэтому гигабайтные базы проходят так же, как
маленькие. Идёт с прогрессом, импорт можно остановить.
- Домен на боевом сервере — необязательное поле: указанный домен заменяется на
имя.bitrixпрямо в потоке импорта, плюс правится адрес площадки в настройках Битрикса. - Очистить базу перед импортом — по умолчанию включено. Без очистки дамп без
DROP TABLE IF EXISTSобрывается на дубликатах ключей. - Архив
.zip/.tar.gzсначала распакуйте — Omut принимает сам дамп.
Импорт доступен во Free. Через Adminer большие дампы не проходят: он гоняет их через PHP
и упирается в memory_limit и таймауты — это ограничение PHP, а не Omut.
Частые проблемы
- Права —
upload/,bitrix/cache/должны быть writable вашему пользователю Mac - Часовой пояс — Настройки → Europe/Moscow
- Сессии — окружение должно быть запущено;
session.save_pathзадаёт Omut - URL в БД — после смены домена обновите
b_option(site_url) или скрипт смены URL
Откат
Скопируйте ~/Omut/ и ~/Library/Application Support/Omut/databases/ перед экспериментами. Откат = вернуть файлы и перезапустить окружение.