installation.mdx

title	description
Installation	Let's install Gradience

The recommended method is to use Flatpak but you can also choose to use a package for your distro (we officialy support AUR and RPM).

Flatpak

To install Gradience, run this command in your terminal:

flatpak install com.github.GradienceTeam.Gradience

This is the preferred method to install Gradience, as it will always install the most recent stable release in a portable way whatever the distribution you use.

If you don't have flatpak installed, this Flatpak installation guide can guide you through the process.

Alternatives methods

Using the [AUR](https://aur.archlinux.org)

paru -S gradience

Using a [RPM](https://rpm.org) package from [COPR](https://copr.fedorainfracloud.org/)

dnf copr enable lyessaadi/gradience
dnf install gradience

Using a [DEB](https://debian.org) package

Not available yet. Feel free to create and share a package.

Avanced methods

From sources

This is the Git version, which can be unstable

The sources for Gradience can be downloaded from the Github repo.

You can either clone the public repository:

git clone git://github.com/GradienceTeam/Gradience

Or download the tarball:

curl -OJL https://github.com/GradienceTeam/Gradience/tarball/master

Once you have a copy of the source, you can install it with:

make install

Git package

If you are using Arch Linux or an Arch based distribution, you can use the gradience-git package from the AUR

This is the Git version, which can be unstable

paru -S gradience-git

Troubleshooting

Here's how to solve some common problems when installing Gradience.

Update your system and retry

Next steps

Setup your system for Gradience Learn how to use gradience