Back to Table of Contents

How to install

This article describes the installation process for MultiBit Classic.


Download the Windows installer.

To run the installer, double click it and follow the instructions.

Once installed, you can start MultiBit Classic with the 'MultiBit Classic' shortcut in your 'All Programs | MultiBit Classic' menu or with your desktop 'MultiBit Classic' shortcut.

You should now read the Getting Started guide.

Common gotchas

On Windows 7 64-bit you may find that the Java Virtual Machine (JVM) is not correctly located, or "Failed to create a selector" is shown in the messages.

A known workaround is to change the compatibility settings:

  1. Select the compatibility dialog (right click on icon | Properties... | Compatibility)
  2. Choose: "Run this program in compatibility mode for Windows XP SP3"
  3. Check the box: "Run this program as an administrator"

As an alternative, consider uninstalling Java and then reinstalling. This has been known to clear out problems.

Mac OS X

Download the Mac OS X installer.

After you have downloaded the disk image file, double click it and a folder window opens.

In the open folder window, drag the MultiBit application to the Applications link. MultiBit Classic will then be copied to your Applications folder

You can then open MultiBit Classic by double clicking on this app in your Applications folder.

You may find on later versions of OS X (Yosemite and El Capitan) that you are prompted to install Java 6. Click the install button which will take you to the Java for OS X 2014-001 support page. Once there click the "Download" button and follow the installation procedure.

After Java 6 is installed you will be able to start MultiBit Classic as normal.

You should now read the Getting Started guide.


Download the Linux / Unix installer.

Open a terminal window and make the installer executable with:

chmod +x multibit-classic-downloadVersionClassic-linux.jar

Run the installer with:

java -jar multibit-classic-downloadVersionClassic-linux.jar

Follow the instructions in the installer.

After installation, you will have a shortcut to start MultiBit Classic in your "Applications | Other" menu.

You should now read the Getting Started guide.

Common gotchas

If you get an error like "No command 'java' found" or the installer window does not appear you probably need to install an up-to-date version of Java. See the section 'How to install Java on Linux' below.

If you see an error "***.desktop (No such file or directory)" this is a glitch in installing the MultiBit Classic shortcuts. If you run the installer again with the same settings it normally fixes it.

If no MultiBit Classic shortcut is created, you can run MultiBit Classic manually as follows:

  1. open a terminal window and 'cd' to your installation directory
  2. type java -jar multibit-exe.jar

How to install Java on Linux

MultiBit Classic recommends Java 7. To install Java on a recent copy of Ubuntu open a terminal window and type:

sudo apt-get install openjdk-7-jdk

You will be prompted for your system password and then it will install the required packages.

If you are running an older version of Ubuntu (e.g. something like Ubuntu 10.4 LTS) you will have to use the following:

sudo apt-get install openjdk-6-jdk

For RedHat / CentOS the installation command is:

yum install java

OpenJDK doesn't work for me...

Some people have had issues using MultiBit Classic with OpenJDK on Arch Linux and OpenSuse distributions. The error manifests when trying to add a password to a wallet and occurs deep within the platform-specific parts of the JVM. If this affects you the error will be like this:

SIGSEGV (0xb) at pc=0x00007f97ec7d06a0, pid=588, tid=140289289742080

After some research members of the MultiBit community found that installing the Oracle Java 7 JVM fixed the problem in some cases.

However further research found a reliable workaround involving deleting from the JAR:

$ zip -d "multibit-exe.jar" lib/x86_64/{freebsd,linux}/
deleting: lib/x86_64/freebsd/
deleting: lib/x86_64/linux/

Related articles

Here are some related articles: