How To: run Git Extensions on Linux

Johan Vervloet edited this page Oct 24, 2018 · 4 revisions


Tested on:
Ubuntu 16.04
Mono 4.6.1
Git 2.7.4
KDiff3 0.9.98
GitExtensions 2.49RC2

  1. Install git: sudo apt install git
    check git: git --version
    git version 2.7.4

  2. Install mergetool kdiff3: sudo apt install kdiff3
    check Kdiff3: kdiff3 --version
    Kdiff3: 0.9.98 (64 bit)

  3. Install Mono to run GitExtensions. Version should be greater than 4.6 5 !!! (and if possible, greater than 5.14)
    Add repository to install the latest version of Mono
    sudo apt-key adv --keyserver hkp:// --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
    echo "deb wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
    sudo apt update
    install: sudo apt install mono-complete
    check: mono --version
    Mono JIT compiler version 4.6.1

  4. Install GitExtensions
    Download latest stable GitExtensions for Linux.
    Unzip to any folder

  5. Start GitExtensions
    Open GitExtensions folder and double click GitExtensions.exe
    If error occurred, then open terminal and execute the following command. sh when you first start you will see a language selection
    select language

  6. Configuring GitExtensions
    check list
    1. and 2. Your name and email
    3. Editor default GitExtensions
    4. kdiff3
    5. /usr/bin/kdiff3
    7. and 8. as 4. and 5.
    9. Whatever you prefer
    10. Unicode (UTF-8)
    Setting GitExtension



The Windows page may have more information: see Build Instructions with Mono

Building the installer

  • Run \Setup\BuildInstallers.Mono.cmd

How to build and test in Mono

Mono 4.4.0 or later is required, because it uses C# 4.6.1 compiler by default. Refer to Git Extensions on Linux for details on how to build and debug on Linux.

Images and Linux compatibility

Not all image formats are supported on Mono. PNG images with a color depth of 48 bpp will cause compiler errors. If you run into this problem you should convert all PNG images to 8 bpp.

This can be done using the following Linux commands:

sudo apt-get install imagemagick
mogrify -depth 8 $(find -iname '*.png')
mogrify -depth 8 $(find -iname '*.PNG')

Running tests

Tests use NUnit under Mono.

Download prebuilt package


macOS Mono support for Git Extensions is unknown.

Note specifically though that you at least in 5.4 must run tMono in 32bit version as the 64bit WinForm support is incomplete. Start with --arch=32.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.