Skip to content

How to Install Qubic Wallet

Installing the Qubic desktop wallet takes a couple of minutes on any supported platform. The release ships in three formats — a Windows .exe installer, a macOS .dmg disk image, and a portable Linux .zip archive — so you use whichever one matches your machine. This guide covers the download, the platform-specific first run, and what happens the first time the wallet opens.

Download From the Official Source Only

Fake wallet builds are one of the most common ways crypto gets stolen, and they are usually distributed through lookalike websites, search ads, or links shared in chat groups. Only ever download the desktop wallet from qubicwallet.io/download or the official GitHub Releases page linked from it. If a download came from anywhere else, delete it and start again from the official page rather than installing it.

Before You Start

Nothing exotic is required — the wallet runs on ordinary consumer hardware and does not need a prior wallet, an account, or a sign-up.

  • Windows 10 or later, macOS Monterey (12) or later, or a modern 64-bit Linux distribution
  • Around 300 MB of free disk space for the installed application
  • An internet connection so the wallet can sync with the network
  • Your existing seed, if you are importing rather than creating a new vault

Install in Four Steps

The same four steps apply on every platform — only the installer format and first-run details differ, and those are covered per platform below.

  1. 01

    Download the installer for your operating system

    Pick the build that matches your platform on the download page: the Windows .exe, the macOS .dmg, or the Linux .zip.
  2. 02

    Run the installer, or extract the archive on Linux

    On Windows the .exe installs itself; on macOS drag the app out of the .dmg into Applications; on Linux extract the .zip somewhere you will keep it — your user folder, not Downloads.
  3. 03

    Launch Qubic Wallet

    Open it from the Start menu on Windows, the Applications folder on macOS, or the extracted directory on Linux.
  4. 04

    Create a new vault or import your seed

    On first run you set a vault password and either generate a new seed or import an existing one.

Installing on Windows

Run the downloaded qubic-wallet-v0.6.3.exe and follow the installer prompts. When it finishes you will find Qubic Wallet in your Start menu.

Because the release is not code-signed with a paid certificate on every build, Windows SmartScreen may show a "Windows protected your PC" notice the first time you launch it. If you downloaded from the official page, choose More info and then Run anyway. If you are not certain where the file came from, don't bypass the warning — delete it and download again from the official page instead.

Installing on macOS

Open the downloaded qubic-wallet-v0.6.3.dmg and drag Qubic Wallet into your Applications folder, then eject the disk image. The same image works on both Apple Silicon and Intel Macs.

The first launch of an app downloaded from the internet is blocked by Gatekeeper. Instead of double-clicking, right-click the app and choose Open, then confirm the prompt. If macOS still refuses, open System Settings → Privacy & Security, scroll to the security section, and choose Open Anyway for the wallet.

Installing on Linux

Extract the archive to a directory you control, then mark the wallet binary as executable before running it. Most desktop environments will also let you create a launcher shortcut afterwards.

Linux (Terminal)
unzip qubic-wallet-v0.6.3.zip -d ~/qubic-wallet
cd ~/qubic-wallet
chmod +x Qubic.Net.Wallet
./Qubic.Net.Wallet

Adjust the archive name to match the file you actually downloaded. Keep the extracted directory intact — the executable depends on the files shipped next to it.

Where the Wallet Lives

Windows and macOS put the app in the usual place for their platform; on Linux you choose the folder yourself.

PlatformLocation after install
Windows (.exe)
Installed to Program Files, launched from the Start menu
macOS (.dmg)
/Applications/Qubic Wallet.app
Linux (.zip)
Wherever you extract it — ~/qubic-wallet is a good default

The First Time the Wallet Opens

The wallet opens on a vault screen rather than a dashboard, because there is nothing to show until a vault exists. You will either create a new vault, which generates a fresh seed on your device, or import an existing seed from the web wallet, the mobile app, or another Qubic-compatible wallet.

Either way you set a vault password. That password encrypts the vault file locally — it is not an account, it cannot be reset by anyone, and it is not a substitute for your seed. If you are new to this, read the seed format guide before you generate anything, since Qubic's 55-character seed does not work like a BIP-39 word list.

During Setup

Do this
  • Write your seed down on paper, offline, before funding the wallet.
  • On Linux, keep the extracted folder intact in one permanent place.
  • Choose a vault password you can actually reproduce from memory.
Not this
  • Screenshot the seed or paste it into notes, chat, or cloud storage.
  • Run the Linux build straight out of a temporary or Downloads folder.
  • Assume support can reset the password or recover the vault for you.

Three Formats, One Application

The same release is published in three formats so each platform gets what it expects: a Windows .exe installer, a macOS .dmg disk image you drag into Applications, and a Linux .zip you extract and run. The Linux build stays portable on purpose — it writes nothing into system directories, needs no root, and can be removed by deleting one folder, which also makes it easy to inspect or move between machines.

Updating to a Newer Release

Updating follows the same path as a first install: download the new build from the official download page, then run the installer on Windows, replace the app in Applications on macOS, or extract the new archive over your Linux folder. Your vault lives separately from the application, so replacing the app does not touch your accounts. Keep your seed backed up anyway before any upgrade — that habit costs nothing and covers every other failure mode. Release-by-release changes are listed on the updates page.

Uninstalling

On Windows, remove Qubic Wallet through Settings → Apps & features. On macOS, drag the app from Applications to the Trash. On Linux, delete the folder you extracted. Do not delete anything until you are certain your seed is backed up somewhere offline — removing the app while your only copy of the seed lives inside it means the accounts are gone permanently, with no recovery path through us or anyone else.

If the Wallet Won't Launch

Almost every failed launch is one of three things. On Windows, SmartScreen is silently blocking an unrecognised app — choose More info → Run anyway. On macOS, Gatekeeper is blocking the first open — right-click the app and choose Open, or allow it under Privacy & Security. On Linux, the archive was only partially extracted or the binary is missing its execute bit — extract it fully to a real folder and run chmod +x on the wallet binary, keeping the supporting files next to it.

If the wallet opens but shows no balance, that is a syncing or address issue rather than an install problem — the balance troubleshooting guide covers it.

Download only from the official download page, use the format built for your platform, and back up your seed offline before you fund the wallet — those three habits prevent nearly every avoidable problem.

Keep reading