Skip to content

If you have any trouble running the image, please consult this section. Don't forget to install gstreamer if you run it on Linux.


Flatpak Install from the Flatpak repository (Linux)

AppImage Download the latest AppImage (Linux)

DMG Download the latest DMG (MacOS)

NSI Download the latest NSI (Windows)

CHANGELOG | Telegram channel | Matrix room.

On startup

You should see a popup like this when you first run it (or during upgrades):

Platform notes

  • Windows: the NSI installers are currently weekly snapshots and do not use live upgrades.


A Flatpak repository is available. First, you should setup Flatpak on your Linux system. To register the Flatpak repository and install the latest version, use the following (as root):

flatpak install

If you want to install it as a regular user:

flatpak install --user

You can now run the application (note that you can use the same command-line flags as with the AppImage):

flatpak run io.gitlab.galacteek.Galacteek

Note: Flatpak stores the application's data files in a separate folder (by default .var/app in your HOME), different from what the AppImage uses.

Updating via Flatpak

flatpak update io.gitlab.galacteek.Galacteek

Automatic AppImage install shell script

There's a script which will download the latest AppImage snapshot, verify the file's checksum, and run it for you. Use the following command from a terminal to run it:

curl -L | bash

Note: This script is provided as a convenience to track the latest AppImage. Downloading the AppImage via the direct links is the recommended way to install the software.


Installing gstreamer (Linux)

To use the mediaplayer inside galacteek you will need to have the gstreamer libraries (you'll need gstreamer 1.0) installed on your system. To install gstreamer and the main plugins on a Debian/Ubuntu system, run the following:

sudo apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-qt5 gstreamer1.0-pulseaudio

If you use another type of Linux distribution, search for and install the gstreamer 1.0 packages and the good, bad and ugly plugins.

How to run the AppImage (Linux)

After downloading the AppImage, make it executable and then run it from the shell or double-click on it from the desktop. Example:

chmod +x Galacteek-0.5.5-x86_64.AppImage

How to run with Flatpak (Linux)

flatpak run io.gitlab.galacteek.Galacteek

Command-line flags

This section describes the various flags that you can pass when you run the AppImage.


Use --config-defaults to restore the default configuration.

Only use this flag if the UI won't start !


Use -d to log debugging messages.


Use --goipfs-debug to log debugging messages from go-ipfs.


Use --profile with a profile name to use a custom application profile. The default profile is called main. Example:

./Galacteek-0.5.5-x86_64.AppImage --profile demo

How to run the DMG image (MacOS)

After opening/mounting the DMG image, hold the Control key and click on the galacteek icon, select Open and then accept. You probably need to allow the system to install applications from anywhere in the security settings.

Release workflow

AppImages are built from GitLab CI. They are uploaded to GitLab packages, and they are also distributed on IPFS, which makes it easier to replicate (a big thanks to Pinata for their amazing service!).

At the moment, the DMG and NSI installers are built from GH Actions.