Skip to content

Sciget App

Download the Sciget App for your operating system, then follow the install instructions below.

Download:

Install: Double-click the downloaded .dmg file and drag ScigetApp into your Applications folder. To open it, right-click ScigetApp.app and select “Open”.

  • At least 5 GB free disk space for the Scidesktop base image
  • A container engine or the TinyRange engine (see Step 2 below)

The Sciget App needs an engine to run. Docker is recommended, Podman is also supported, and TinyRange is available for systems without admin/root access.

Engine options

Requires: admin/root access on your machine.

If you already have Docker installed, skip to Step 3. Otherwise, install Docker:

Verify your installation:

Terminal window
docker --version
docker run hello-world

Apple silicon users: enable Rosetta support in Docker Desktop settings for best performance.

Open the Sciget App from your operating system’s application menu, or run scigetapp from the command line.

On the Welcome Page you have two options:

  • Launch Local creates a new session on your machine.
  • Launch Remote connects to an existing Sciget server running elsewhere.

Start session

Click “Launch Local” on the mini app you want to start. This opens a JupyterLab interface.

Click the scidesktop icon to open the full Linux desktop. Choose Desktop RDP (recommended) or Desktop VNC. The app will load into a full Linux desktop environment with Software-Applications on the desktop to choose from.

Connect to local

Click “Launch Remote” to connect to a server running elsewhere.

Select a server from the list, or enter the URL of the application server. If the server requires a token for authentication, include it as a query parameter of the URL (/lab?token=<token-value>). Press Enter to connect.

Use your GitHub credentials to log in, then click Start to launch Scidesktop.

Connect to server

Mini apps store data in ~/<miniapp>-storage on Linux and macOS, or C:/<miniapp>-storage on Windows by default.

In Settings, select “Additional Directory” in the sidebar, click “Change” to choose a local directory, then click “Apply & restart”. The directory will appear at /home/jovyan/data inside the app.

Additional Directory settings interface

You can delete stored session data manually at any time using the Clear History option in the Privacy tab of the Settings dialog.

Settings privacy

/var/run/docker.sock: connect: permission denied

Section titled “/var/run/docker.sock: connect: permission denied”

This means Docker is not correctly set up yet. Run:

Terminal window
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
sudo chown root:docker /var/run/docker.sock
sudo chmod 666 /var/run/docker.sock

If you see the error FATAL:setuid_sandbox_host.cc(158)] The SUID sandbox helper binary was found, but is not configured correctly..., this is caused by a recent change in Ubuntu 24.04.

A temporary workaround: create the file /etc/apparmor.d/scigetapp with this content:

# This profile allows everything and only exists to give the
# application a name instead of having the label "unconfined"
abi <abi/4.0>,
include <tunables/global>
profile scigetapp "/opt/ScigetApp/scigetapp" flags=(unconfined) {
userns,
# Site-specific additions and overrides. See local/README for details.
include if exists <local/scigetapp>
}

Then restart your computer and try to start the Sciget App again.

Find ScigetApp.app in Finder (in /Applications or ~/Applications) and move to Trash using CMD + Delete. Then clean up:

Terminal window
rm -rf ~/Library/scigetapp # remove application cache
rm -rf ~/Library/Application\ Support/scigetapp # remove user data