Github Codespaces

Use Neurodesk on GitHub Codespaces

Start a GitHub Codespace in the repository of your choice:
Start GitHub Codespace

Then start the neurodesktop container in a terminal:

docker volume create neurodesk-home &&
sudo docker run \
  --shm-size=1gb -it --security-opt apparmor=neurodeskapp --privileged --user=root --name neurodesktop \
  -v ~/neurodesktop-storage:/neurodesktop-storage \
  --mount source=neurodesk-home,target=/home/jovyan \
  -e NB_UID="$(id -u)" -e NB_GID="$(id -g)" \
  -p 8888:8888 \
  -e NEURODESKTOP_VERSION=2025-04-08 ghcr.io/neurodesk/neurodesktop/neurodesktop:2025-04-08

Then open Neurodesktop in the browser by clicking the “Open in Browser” Button displayed
Pop up on GitHub Codespace

The token for authentication is displayed in the terminal: alt text