CubicLauncher est publié sous forme d'image de conteneur multi-architecture sur GitHub Packages pour linux/amd64 et linux/arm64.
- Dépôt : CubicLauncher
- Image : ghcr.io/cubiclauncherdevs/cubiclauncher
CubicLauncher doit accéder au serveur graphique de l'hôte. Le conteneur n'inclut ni environnement de bureau ni serveur X11 ou Wayland.
Prérequismodifier
- Docker installé sur l'hôte.
- Un serveur graphique X11 ou Wayland en cours d'exécution.
- Accès à
/dev/dripour l'accélération graphique. - Un volume ou un dossier pour conserver les données de
~/.cubic.
Obtenir l'imagemodifier
docker pull ghcr.io/cubiclauncherdevs/cubiclauncher:latestLes étiquettes publiées sont la version complète (36.0.1), la version mineure (36.0), la version majeure (36) et latest. latest pointe uniquement vers la dernière version stable ; les préversions ne reçoivent que leur propre étiquette.
Exécuter avec X11modifier
Autorisez votre utilisateur local à se connecter au serveur X11, puis démarrez le conteneur :
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:latestUne fois terminé, vous pouvez révoquer l'autorisation :
xhost -si:localuser:$(id -un)Exécuter avec Waylandmodifier
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:latestDonnées persistantesmodifier
Le volume cubic-data conserve ~/.cubic : les instances, les réglages et le JRE téléchargé par le launcher.
Pour utiliser les données de votre utilisateur sur l'hôte, montez directement le dossier :
-v "$HOME/.cubic:/data/.cubic"L'image fonctionne avec n'importe quel UID grâce à --user, mais le répertoire /data doit être accessible en écriture par cet UID. Le volume est créé avec les permissions 1777.
NVIDIAmodifier
Si vous utilisez un GPU NVIDIA, installez nvidia-container-toolkit et ajoutez --gpus all à la commande X11 ou Wayland.
Si l'interface apparaît vide, essayez de désactiver le rendu DMA-BUF de WebKit :
-e WEBKIT_DISABLE_DMABUF_RENDERER=1Audiomodifier
Pour PulseAudio, montez le socket du serveur et définissez PULSE_SERVER selon votre configuration. Pour ALSA, ajoutez le périphérique audio :
--device /dev/sndLimitationsmodifier
- Le programme de mise à jour intégré ne fonctionne pas dans le conteneur. Pour mettre à jour, téléchargez la nouvelle étiquette de l'image.
- Le conteneur n'installe pas les pilotes graphiques de l'hôte ; configurez-les sur le système hôte.
- Si WebKit échoue au démarrage à cause du sandbox, essayez
--security-opt seccomp=unconfined.
Compiler l'image localementmodifier
Depuis la racine du dépôt :
docker build -t cubiclauncher .Le workflow .github/workflows/docker.yml publie l'image lors de la création d'un tag v*. Pour publier manuellement la dernière version, lancez Actions → Docker Image → Run workflow et laissez le champ tag vide ; la dernière version stable sera résolue automatiquement. Si vous indiquez une étiquette précise qui n'est pas la dernière version, latest ne sera pas déplacé.