CubicLauncher se publica como imagen de contenedor multiarquitectura en GitHub Packages para linux/amd64 y linux/arm64.
- Repositorio: CubicLauncher
- Imagen: ghcr.io/cubiclauncherdevs/cubiclauncher
CubicLauncher necesita acceder al servidor gráfico del host. El contenedor no incluye un entorno de escritorio ni un servidor X11 o Wayland propio.
Requisitoseditar
- Docker instalado en el host.
- Un servidor gráfico X11 o Wayland en funcionamiento.
- Acceso a
/dev/dripara la aceleración gráfica. - Un volumen o carpeta para conservar los datos de
~/.cubic.
Obtener la imageneditar
docker pull ghcr.io/cubiclauncherdevs/cubiclauncher:latestLas etiquetas publicadas son la versión completa (36.0.1), la versión menor (36.0), la mayor (36) y latest. latest solo apunta al release estable más reciente; las versiones preliminares únicamente reciben su propia etiqueta.
Ejecutar con X11editar
Permite que tu usuario local se conecte al servidor X11 y arranca el contenedor:
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:latestCuando termines, puedes revocar el permiso:
xhost -si:localuser:$(id -un)Ejecutar con Waylandeditar
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:latestDatos persistenteseditar
El volumen cubic-data conserva ~/.cubic: las instancias, los ajustes y el JRE que descarga el launcher.
Para usar los datos de tu usuario en el host, monta la carpeta directamente:
-v "$HOME/.cubic:/data/.cubic"La imagen funciona con cualquier UID mediante --user, pero el directorio /data debe ser escribible por ese UID. El volumen se crea con permisos 1777.
NVIDIAeditar
Si usas una GPU NVIDIA, instala nvidia-container-toolkit y añade --gpus all al comando de X11 o Wayland.
Si la interfaz aparece en blanco, prueba a desactivar el renderizador DMA-BUF de WebKit:
-e WEBKIT_DISABLE_DMABUF_RENDERER=1Audioeditar
Para PulseAudio, monta el socket del servidor y define PULSE_SERVER según tu configuración. Para ALSA, añade el dispositivo de sonido:
--device /dev/sndLimitacioneseditar
- El actualizador integrado no funciona dentro del contenedor. Para actualizar, descarga la nueva etiqueta de la imagen.
- El contenedor no instala los controladores gráficos del host; debes configurarlos en el sistema anfitrión.
- Si WebKit falla al iniciar por el sandbox, prueba
--security-opt seccomp=unconfined.
Compilar la imagen localmenteeditar
Desde la raíz del repositorio:
docker build -t cubiclauncher .El workflow .github/workflows/docker.yml publica la imagen al crear un tag v*. Para publicar el último release manualmente, ejecuta Actions → Docker Image → Run workflow y deja el campo tag vacío; se resolverá automáticamente el último release estable. Si indicas una etiqueta concreta que no sea el último release, latest no se moverá.