CubicLauncher публикуется как мультиархитектурный образ контейнера на GitHub Packages для linux/amd64 и linux/arm64.
- Репозиторий: CubicLauncher
- Образ: ghcr.io/cubiclauncherdevs/cubiclauncher
CubicLauncher должен иметь доступ к графическому серверу хоста. Контейнер не содержит рабочего окружения и собственного сервера X11 или Wayland.
Требованияредактировать
- Docker, установленный на хосте.
- Работающий графический сервер X11 или Wayland.
- Доступ к
/dev/driдля аппаратного ускорения. - Том или папка для хранения данных
~/.cubic.
Получение образаредактировать
docker pull ghcr.io/cubiclauncherdevs/cubiclauncher:latestПубликуемые теги: полная версия (36.0.1), минорная версия (36.0), мажорная версия (36) и latest. latest указывает только на последний стабильный релиз; предварительные версии получают только собственный тег.
Запуск с X11редактировать
Разрешите локальному пользователю подключаться к серверу X11 и запустите контейнер:
xhost +si:localuser:$(id -un)
docker run --rm -it \
--user "$(id -u):$(id -g)" \
-e HOME=/data \
-e DISPLAY \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v cubic-data:/data \
--device /dev/dri \
ghcr.io/cubiclauncherdevs/cubiclauncher:latestПосле завершения можно отозвать разрешение:
xhost -si:localuser:$(id -un)Запуск с Waylandредактировать
docker run --rm -it \
--user "$(id -u):$(id -g)" \
-e HOME=/data \
-e XDG_RUNTIME_DIR=/run/user/$(id -u) \
-e WAYLAND_DISPLAY \
-e GDK_BACKEND=wayland \
-v "$XDG_RUNTIME_DIR:/run/user/$(id -u)" \
-v cubic-data:/data \
--device /dev/dri \
ghcr.io/cubiclauncherdevs/cubiclauncher:latestПостоянные данныередактировать
Том cubic-data сохраняет ~/.cubic: экземпляры, настройки и JRE, загруженную лаунчером.
Чтобы использовать данные вашего пользователя на хосте, смонтируйте папку напрямую:
-v "$HOME/.cubic:/data/.cubic"Образ работает с любым UID благодаря --user, но каталог /data должен быть доступен для записи этому UID. Том создаётся с правами 1777.
NVIDIAредактировать
Если вы используете GPU NVIDIA, установите nvidia-container-toolkit и добавьте --gpus all в команду для X11 или Wayland.
Если интерфейс отображается пустым, попробуйте отключить рендерер DMA-BUF в WebKit:
-e WEBKIT_DISABLE_DMABUF_RENDERER=1Звукредактировать
Для PulseAudio смонтируйте сокет сервера и задайте PULSE_SERVER в соответствии с вашей конфигурацией. Для ALSA добавьте звуковое устройство:
--device /dev/sndОграниченияредактировать
- Встроенное средство обновления не работает внутри контейнера. Для обновления загрузите новый тег образа.
- Контейнер не устанавливает графические драйверы хоста; настройте их в хост-системе.
- Если WebKit не запускается из-за sandbox, попробуйте
--security-opt seccomp=unconfined.
Локальная сборка образаредактировать
Из корня репозитория:
docker build -t cubiclauncher .Workflow .github/workflows/docker.yml публикует образ при создании тега v*. Чтобы вручную опубликовать последний релиз, запустите Actions → Docker Image → Run workflow и оставьте поле tag пустым; последний стабильный релиз будет определён автоматически. Если указать конкретный тег, не являющийся последним релизом, latest не будет перемещён.