Installing CKAN on Steam Deck

**NOTE: These instructions might not work in the future. The Lutris-Method was last revised in 07.2024. The Distrobox-Method does not currently work.

These instructions were contributed by CKAN users who have Steam Decks (no one on the CKAN team has one).

Proceed only if you are prepared to figure things out yourself, and we'd love it if you could make improvements!**

---

The Steam Deck's operating system features an immutable root filesystem, meaning Mono itself can't be installed. To get around this we can use Lutris to run it with Wine and Mono for wine. We can also use Distrobox to create a container in which we can install Mono and CKAN.

Lutris Method

Installing Lutris and mono

Open the Desktop Mode. Install Lutris and mono via Discover. See Lutris downloads page for more info.

Installing CKAN

Download the latest ckan.exe from GitHub Releases. In Lutris, add an already installed game and select the CKAN exe. As runner select Wine, for arguments you need to set --asroot.

Install dependencies within Lutris

Within Lutris select the wine glass, then wine tricks. There will be some wait time while wine sets itself up. Winetricks has the quirk, that it likes to open popups in the background. Keep that in mind, you might need to open them up through the task bar. To make the following steps less painfull, select „disable silent install“ in the wintetricks window. You will need to add dotnet48 to the wine prefix. Select "add windows dependencies or DLLs", scroll down to dotnet48, select and click OK. If you have silent install active, get a snack and a book to read. You will need to wait quite some time! If you have silent install disabled, walk through the installation.

You can optionally copy the ckan exe into the new "game" drive_c and set CKAN's Lutris config to point to the same file.

Prepare KSP

Open the file manager, in the left panel click on "Home". Then click on the burger menu on the top right (the three horizontal bars) and select "show hidden files". Navigate to .local/share/Steam/steamapps/common/Kerbal Space Program. You will see KSP.x86_64. Klick and hold it, press the right shoulder button and drag the icon to a free place in the folder. This creates a link. You will be prompted to enter a new link name. Enter KSP_x64.exe, so CKAN recognises the executable.

Running CKAN for the first time

Start CKAN in Lutris. When selecting a new instance navigate to /home/deck, you'll need to type .local to continue on to /home/deck/.local/share/Steam/steamapps/common/Kerbal Space Program or wherever you have KSP installed. Select KSP_x64.exe.

Adding CKAN to Steam

Right Click CKAN and and select the corresponding menu entry to add a link to Steam. I highly recommend you start CKAN in Desktop Mode for the first setup and initial configurations, as the UI-scaling in Gaming-Mode does not work properly and you can not exit the settings menu without stopping CKAN entirely.

For regular mod management the Desktop mode works well enough. Set the controller layout for CKAN to "Mouse Only", as CKAN does not support controller input.

Distrobox Method

NOTE: These instructions currently do not work. The install-podman script was deprecated and the original contributors are no longer around to fix the instructions. We‘d love it if you could make improvements.

Installing Distrobox

Open Konsole in desktop mode and run the following two commands:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --prefix ~/.local
curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/extras/install-podman | sh -s -- --prefix ~/.local

This will install Distrobox, as well as Podman, the container software that Distrobox is built on.

Then, open your /home/deck/.bashrc file in a text editor such as KWrite and add the following lines at the end:

xhost +si:localuser:$USER
export PATH=$HOME/.local/bin:$PATH
export PATH=$HOME/.local/podman/bin:$PATH

The first line grants applications on Distrobox the required permissions to connect to the X server (and therefore open graphical windows). The last two lines add Distrobox and Podman to the PATH variable so we can actually run them.

Creating a container

In a new Konsole window, run distrobox create -i archlinux. When asked if you want to pull the image, press enter at the Y/n prompt and select the top option. This will create a new container running Arch Linux, which we can install Mono into without requiring write access to the Deck's root filesystem.

Enter your new container with distrobox enter archlinux.

Installing Mono

In the container, run sudo pacman -S mono to install Mono. Press enter at any y/n prompts. This will instalk Mono into the container.

Installing CKAN

Download the latest ckan.exe from GitHub Releases. Inside the container, run mono path/to/ckan.exe (replacing path/to/ckan.exe with the actual location of the file; this will usually be Downloads/ckan.exe if you just downloaded it). CKAN should open, and KSP should be auto-detected if it has been installed via Steam.

To run CKAN from outside the container, you can use distrobox enter archlinux -- mono path/to/ckan.exe.

To make it easier to launch CKAN, create a new text file called ckan.sh in the same folder as ckan.exe with the following contents:

#!/usr/bin/env sh
export PATH=/home/deck/.local/bin:$PATH  # Import distrobox utilities
export PATH=/home/deck/.local/podman/bin:$PATH  # Import distrobox utilities
xhost +si:localuser:$USER  # To allow distrobox to open graphical applications
# rm -rf "/home/deck/.local/share/steam/steamapps/Kerbal Space Program/CKAN/registry.locked"
distrobox enter archlinux -- mono ckan.exe  # Run the CKAN application

Set this file as executable in its properties (right click), and open it to run CKAN. You can also add this file to Steam as a non-Steam game to access CKAN from Gaming Mode.

Running in Gaming Mode

Right click on ckan.sh and select Add to Steam to add CKAN as a non-Steam game. Edit ckan.sh and remove the # at the start of the rm -rf line; we need to remove the lock file as Steam force-quits applications when you exit them in gaming mode. If your KSP install is not in the default Steam location you will need to change the file path here appropriately.

However, there are some graphical issues in gaming mode, so you may want to stick to running CKAN in desktop mode. You may want to create a .desktop file on your desktop that runs your ckan.sh file.

Keeping your container updated

It's a good idea to keep the packages in your container up to date; you can do this with distrobox enter archlinux -- sudo pacman -Syu.