Переезд на Omut

Миграция с OSPanel или Docker.

Краткий гайд для разработчиков с OSPanel или Docker.

Общая схема

  1. Установите Omut.
  2. Скопируйте файлы проекта в ~/Omut/имя-сайта.bitrix/ (корень — где лежит /bitrix/).
  3. Импортируйте дамп БД: меню сайта () → Импорт дампа базы (или разверните бэкап через restore.php).
  4. Проверьте .settings.php / dbconn.php — хост localhost, сокет MySQL подхватывается автоматически.

С OSPanel / OpenServer

OSPanelOmut
domains/~/Omut/имя.bitrix/
MySQL в панелиMySQL 8.4 по умолчанию
.local доменыимя.bitrix
phpMyAdminAdminer из меню сайта
Импорт дампа в phpMyAdminИмпорт дампа базы — напрямую в MySQL, мимо PHP

Шаги:

  1. Остановите OSPanel (освободите порты 80/443/3306).
  2. Скопируйте папку сайта.
  3. Сделайте mysqldump в OSPanel и залейте файл через Импорт дампа базы.
  4. В .settings.php — хост localhost, пользователь root, пароль пустой (или креды вашей dev-БД).

С Docker

  1. docker compose down — освободите порты.
  2. Скопируйте volume с файлами в ~/Omut/.
  3. Экспорт: docker exec … mysqldump … > dump.sql, дальше Импорт дампа базы в меню сайта.
  4. Замените хосты 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/ перед экспериментами. Откат = вернуть файлы и перезапустить окружение.