Linux Repositories

Using QTUM Official Repository on Linux

We've published our official Qtum repository on https://repo.qtum.info. This repository supports the following distributions:

Debian

  • 8.x (Jessie)

  • 9.x (Stretch)

  • 10.x (Buster)

  • 11.x (Bullseye)

  • 12.x (Bookworm)

  • 13.x (Trixie)

  • Testing (Forky)

  • Unstable (Sid)

Ubuntu

  • 16.04 (Xenial Xerus)

  • 18.04 (Bionic Beaver)

  • 20.04 (Focal Fossa)

  • 22.04 (Jammy Jellyfish)

  • 24.04 (Noble Numbat)

Other Official Repositories

CentOS/Fedora/RedHat

Tested on CentOS 7, 8, Stream 9, and Fedora 30+. Other releases should work fine as well.

Repository: https://rpmrepo.qtum.info

Arch Linux

Get it from the AUR

More distributions will be added in the future, and this document will be updated to reflect those changes.

Tutorial Focus

This tutorial assumes you have a basic knowledge of Linux and terminal usage. The entire process uses the Linux terminal.

Installing on Ubuntu

1. Obtain Signing Key

First, we need to obtain the Qtum signing key from the Ubuntu keyserver:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BF5B197D

This will download and add the Qtum signing key to your Linux installation.

2. Add Repository to Your APT Sources

echo "deb https://repo.qtum.info/apt/ubuntu/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/qtum.list

This automatically detects your Ubuntu version and adds the appropriate repository.

3. Refresh APT Sources and Install Qtum

sudo apt update && sudo apt install qtum

This will update your sources and install Qtum on your Ubuntu system.

Installing on Debian

The Debian installation process is identical to Ubuntu, with the repository automatically detecting your Debian version.

Prerequisites (Debian Only)

First, ensure you have the required packages installed:

sudo apt install -y apt-transport-https dirmngr

If you're on a minimal Debian installation and sudo is not installed:

  1. Obtain admin privileges: su - (then enter root password)

  2. Install sudo: apt-get install sudo

  3. Add your user to the sudo group: usermod -aG sudo yourusername

  4. Logout and log back in

1. Obtain Signing Key

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BF5B197D

This downloads and installs the Qtum public key.

2. Add Repository to Your APT Sources

echo "deb https://repo.qtum.info/apt/debian/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/qtum.list

This automatically detects your Debian version codename and adds the appropriate repository.

3. Refresh APT Sources and Install Qtum

sudo apt update && sudo apt install qtum

This will update your sources and install Qtum on your Debian system.

Install on CentOS/RedHat/Fedora

These are the steps you need to take to install Qtum in an RPM-based distribution:

1. Install the Public Key

sudo rpm --import https://rpmrepo.qtum.info/key.asc

2. Add the Qtum Repository

sudo yum-config-manager --add-repo https://rpmrepo.qtum.info/

3. Update Package Lists

sudo yum update

4. Install Qtum

sudo yum install qtum

Note: You can also use dnf instead of yum on Fedora and distributions that support it:

sudo dnf update
sudo dnf install qtum

Install on Arch Linux

To install on Arch, the easiest way is to use yay: https://aur.archlinux.org/packages/yay

Install from Binary (Recommended)

yay -S qtum-core-bin

This will install the pre-compiled binary package. When prompted, press 1 to confirm the installation.

Install from Source (Alternative)

yay -S qtum-core

Note: Building from source will take significantly longer to compile. In most cases, we recommend using the binary release (qtum-core-bin).

Launching Qtum

GUI Wallet

Launching is simple. Go to your applications menu and search for "Qtum" or navigate to it in your menu:

  • Ubuntu/Debian: Applications → Internet → Qtum Core

  • Fedora/CentOS: Activities → Show Applications → Qtum Core

  • Arch Linux: Application Launcher → Internet → Qtum Core

Command Line

You can also start Qtum from the terminal:

Start the daemon:

qtumd -daemon

Start the GUI wallet:

qtum-qt

Use the CLI tool:

qtum-cli help
qtum-cli getblockchaininfo

Updating Qtum

When a new version is released, you can update Qtum using your package manager:

Ubuntu/Debian:

sudo apt update && sudo apt upgrade qtum

CentOS/RedHat/Fedora:

sudo yum update qtum
# or
sudo dnf upgrade qtum

Arch Linux:

yay -Syu qtum-core-bin

Uninstalling Qtum

If you need to remove Qtum:

Ubuntu/Debian:

sudo apt remove qtum

To remove configuration files as well:

sudo apt purge qtum

CentOS/RedHat/Fedora:

sudo yum remove qtum
# or
sudo dnf remove qtum

Arch Linux:

yay -R qtum-core-bin

Note: Uninstalling the package does not delete your wallet or blockchain data. These are stored in ~/.qtum/ and must be manually removed if desired.

Troubleshooting

GPG Key Issues

If you encounter GPG key errors, try re-importing the key:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BF5B197D

Repository Not Found

Verify that your distribution version is supported:

lsb_release -cs

If your version is not listed in the supported distributions, you may need to build from source or use Docker.

Permission Denied

Ensure you have sudo privileges:

sudo -v

If this fails, contact your system administrator or add your user to the sudo group.

Additional Resources

  • Official Website: https://qtum.org

  • GitHub Repository: https://github.com/qtumproject/qtum

  • Documentation: https://docs.qtum.info

  • Block Explorer: https://qtumexplorer.io

Last Updated: November 2025 Qtum Core Version: 29.1

PreviousUsing Qtum WalletNextQtum on Raspberry Pi

Last updated