Gaphor on Linux

Development Environment

To setup a development environment with Linux, you first need the latest stable version of Python. In order to get the latest stable version, we recommend that you install pyenv. Install the pyenv prerequisites first, and then install pyenv:

$ curl | bash

Make sure you follow the instruction at the end of the installation script to install the commands in your shell’s rc file. Finally install the latest version of Python by executing:

$ pyenv install 3.x.x

Where 3.x.x is replaced by the latest stable version of Python.

Next install the Gaphor prerequisites by installing the gobject introspection and cairo build dependencies, for example, in Ubuntu execute:

$ sudo apt-get install -y python3-dev python3-gi python3-gi-cairo
gir1.2-gtk-3.0 libgirepository1.0-dev libcairo2-dev

Clone the repository.

$ cd gaphor
$ source venv
$ poetry run gaphor

Create a Flatpak Package

The main method that Gaphor is packaged for Linux is with a Flatpak package. Flatpak is a software utility for software deployment and package management for Linux. It offer a sandbox environment in which users can run application software in isolation from the rest of the system.

We distribute the official Flatpak using Flathub, and building of the image is done at the Gaphor Flathub repository.

  1. Install Flatpak

  2. Install flatpak-builder

    $ sudo apt-get install flatpak-builder
  3. Install the GNOME SDK

    $ flatpak install flathub org.gnome.Sdk 3.34
  4. Clone the Flathub repository and install the necessary SDK:

    git clone
    $ cd org.gaphor.Gaphor
    $ make setup
  5. Build Gaphor Flatpak

    $ make
  6. Install the Flatpak

    $ make install

Linux Distribution Packages

Examples of Gaphor and Gaphas RPM spec files can be found in PLD Linux repository:



Please, do not hesitate to contact us if you need help to create a Linux package for Gaphor or Gaphas.