Bitcoin Classic Logo

Installing on Ubuntu

The Classic project maintains a package repository at

Removing other clients / repos

if you have other Bitcoin repositories or clients installed, you should remove these using the package management features. If you are certain you do not have any other bitcoin installed, you may skip directly ahead to the installation.

You can check if there is any bitcoin packages installed by running;

dpkg -l bitcoin*

If the output lists a bitcoin-qt or bitcoind package, you have some other Bitcoin software installed. If neither of these are returned in your listing, you can skip directly ahead to the installation.

We will now remove the software, this will only remove the conflicting parts. The personal data, like a wallet or the blockchain-data will not be removed. Before we start, please ensure that your bitcoind or bitcoin-qt application is not running (shut it down cleanly as necessary).
Then remove its package by running:

sudo apt-get remove bitcoin-qt bitcoind

Continue only if the removal of the package(s) was successful!

As a next step, remove other Bitcoin software repositories, as their packages may conflict with those of Classic. For example, if you have the Bitcoin Core PPA installed previously, you can remove it as follows:

sudo apt-add-repository --remove ppa:bitcoin/bitcoin

Running the apt-cache policy | grep bitcoin command should now produce an empty output.

You are now ready to install the Classic PPA and software packages.

Installing the Classic repository information (PPA)

The following command will install the repository information for Bitcoin Classic:

sudo apt-add-repository ppa:bitcoinclassic/bitcoinclassic

If that is successful, you should update the available package information using

sudo apt-get update

Installing the Classic client software

There are two software packages which you can install:

  • bitcoin-qt, the graphical client
  • bitcoind, the headless client (usually run as a daemon, or service)

You can install either or both of these with:

sudo apt-get install bitcoin-qt
sudo apt-get install bitcoind

They can also be installed together (although only one of them can be run at a time). After installation, you should have the respective binary package installed in /usr/bin/

Installing on generic Linux

Prebuilt binaries are also provided in compressed tar archives (.tgz) for 32- and 64-bit Linux systems.

Attempting to run the 64-bit binaries on a 32-bit machine will fail. If in doubt, you can check your Linux using

uname -m

If the output is x86_64 you should obtain the 64-bit version, otherwise the 32-bit version.

Without going into full details, the installation steps are as follows:

  1. Download the appropriate tar archive. The "Download" link at downloads will take you to the latest release, where you should find .tar.gz files for 32- and 64 bit Linux systems.

  2. Unpack it in a place of your choice. The software can be run from any ordinary user's folder. For example:

    cd /path/where/you/want/to/unpack
    tar xf bitcoin-1.x.y-linux64.tar.gz

    In the example above, x and y indicate software versions. This will create a versioned subfolder, e.g. bitcoin-1.x, containing the Classic software.

  3. Run the executable from its installation location (if necessary adapting your PATH setting)


The archives contain both the graphical and headless clients. The executables are contained in the bin subfolder:


There are also other binaries such as the command line RPC client, bitcoin-cli.