Оригинал: https://timofei-ermolaev.ru/courses/open-webui/install/

Раздел 2 из 7

# Установка Open WebUI: выбор способа и первый запуск

Автор курса — [Тимофей Ермолаев](<https://timofei-ermolaev.ru/ob-avtore/>)

Выберите способ установки Open WebUI, подготовьте Windows, macOS или Linux и запустите приложение с постоянным хранилищем данных.

8 уроков 2 ч 20 мин Практический маршрут

## Как выбрать подходящую инструкцию

Вы уже определили, для чего нужен Open WebUI. Теперь решите, где будет работать само приложение: на вашем компьютере или на сервере. Операционная система устройства с браузером и система, на которой установлен сервис, могут различаться. Если подключаетесь с Windows к Linux-серверу, готовить нужно серверное окружение.

В уроке выбора схемы разберём размещение приложения и модели, хранение данных и доступ. Затем подготовим среду для своей ОС. Для Windows, macOS и Linux предусмотрены отдельные маршруты; достаточно пройти один подходящий.

## Подготовка и запуск решают разные задачи

Подготовительный урок заканчивается проверкой Docker, Compose и рабочей среды. Сам Open WebUI запускается в следующей инструкции. Для Windows курс использует Docker Desktop и терминал Ubuntu в WSL2; на macOS и Linux среда готовится по своим правилам.

После подготовки Windows, macOS или Ubuntu Linux перейдём к общему уроку Docker Compose. В нём выберем свой терминал и сохраним конфигурацию приложения в файле. Для Windows также доступен альтернативный запуск одной командой docker run. Проходить обе установки на одном экземпляре не требуется.

- Выберите место работы приложения и источник модели.
- Подготовьте подходящую ОС и проверьте среду запуска.
- Установите Open WebUI одним способом.
- Проверьте, что интерфейс открывается, а данные сохраняются в постоянном хранилище.

## Что проверить после установки

Открывающаяся страница Open WebUI подтверждает, что приложение доступно. Для ответа в чате ещё понадобится подключить модель. До этого сохраните сведения о способе запуска, месте хранения данных и постоянном ключе приложения: они пригодятся при обновлении.

Открытие сервиса для других пользователей требует продумать доступ и защиту соединения. Подготовка удалённого сервера, HTTPS, Kubernetes, Python и другие способы установки входят в дальнейший план; доступные сейчас инструкции перечислены ниже.

- [Следующий шаг: первый вход и подключение модели](<https://timofei-ermolaev.ru/courses/open-webui/configure/>)
- [Официальное руководство по установке](<https://docs.openwebui.com/getting-started/quick-start/>)

## Уроки раздела

Это опубликованные уроки раздела. Для установки выберите одну подходящую ветку; другие темы можно читать по своей задаче.

[Вся программа курса](<https://timofei-ermolaev.ru/courses/open-webui/#program>)

1. [1 **Выбираем схему установки**Поможем выбрать способ запуска Open WebUI, разобраться с хранением данных и доступом и перейти к подходящему уроку установки.  Конспект 6 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/choose/>)
2. [2 **Windows: WSL2 и Docker Desktop для Open WebUI**Подготовим Windows 11 к установке Open WebUI в контейнере: настроим подсистему WSL2 с Ubuntu, подключим Docker Desktop и проверим рабочее окружение перед запуском сервиса.  Практика 25 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/windows-wsl/>)
3. [3 **Подготовка Docker для macOS**Подготовим Mac к запуску Open WebUI: установим Docker Desktop, проверим команды в Терминале, OpenSSL и рабочую папку проекта.  Практика 25 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/podgotovka-docker-dlya-macos/>)
4. [4 **Подготовка Docker для Linux**Подготовим Ubuntu 24.04 LTS к запуску Open WebUI: установим Docker Engine с плагином Compose и проверим, как команды в терминале обращаются к локальному движку. Затем проверим OpenSSL и подготовим папку для файлов проекта.  Практика 30 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/podgotovka-docker-dlya-linux/>)
5. [5 **Устанавливаем Open WebUI в Docker: Windows и WSL2**В этом уроке мы развернём новый локальный экземпляр Open WebUI на Windows через Docker Desktop и терминал Ubuntu в WSL2 с помощью команды docker run. Мы подготовим постоянный секретный ключ в отдельной папке, подключим именованный том для хранения базы данных и чатов, а затем откроем веб-интерфейс в браузере Windows на том же компьютере.  Практика 12 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/docker/>)
6. [6 **Установка Open WebUI через Docker Compose**Установим Open WebUI через Docker Compose на Windows, macOS или Ubuntu Linux. Сохраним настройки, постоянный ключ и данные, проверим запуск и разберём ошибки.  Практика 20 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/docker-compose/>)
7. [7 **Open WebUI Desktop: установка и первый запуск**Поможем установить Open WebUI Desktop на Windows, macOS или Ubuntu, запустить локальный сервер или подключиться к существующему и разобраться с хранением данных.  Практика 12 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/open-webui-desktop/>)
8. [8 **Open WebUI как приложение на компьютере и телефоне**Поможем добавить Open WebUI как приложение на компьютер или телефон, выбрать подходящий адрес сервера и разобраться с входом, уведомлениями и доступом по сети.  Практика 10 мин](<https://timofei-ermolaev.ru/courses/open-webui/install/open-webui-kak-prilozhenie/>)