Explorer GitHub

Install guide

Install Cronos Wallet on your desktop

Step-by-step guide for installing Cronos Wallet on Windows, macOS or Linux, completing the first-run setup and connecting to Cronos mainnet or testnet.

For users Cronos Wallet Onboarding
Quick navigation
Overview Start here Download & supported OS Compatibility Install on Windows / macOS / Linux Steps First run & wallet setup Onboarding

Overview

Cronos Wallet is a non-custodial desktop wallet designed for secure interaction with the Cronos blockchain and other EVM networks. This guide walks you through download, installation and initial setup — everything needed to safely start using Cronos dApps.

If you’re just entering the Cronos ecosystem, consider reviewing Getting started or the main site’s homepage to understand where Cronos fits in the broader web3 landscape.

Download & supported operating systems

Always download the wallet from the official Downloads section on the main website. Avoid files shared via DMs, chats, cloud folders or third-party mirrors — these are the most common vectors for malware in the crypto space.

Windows
Windows 10/11, 64-bit. Available as a signed .exe installer.
macOS
macOS 12+ (Intel & Apple Silicon). Distributed as a signed .dmg.
Linux
AppImage for portable use; .deb / .rpm for system installs.
IMPORTANT Verify file names, developer signatures and checksums when available. Only the official site publishes authentic builds.

Install on Windows / macOS / Linux

Windows

  1. Visit Downloads and choose the Windows installer.
  2. Save CronosWallet-Setup-x.y.z.exe locally.
  3. Run the installer and follow system prompts.
  4. If SmartScreen appears, confirm the verified Cronos publisher before continuing.
  5. Launch Cronos Wallet from the Start Menu.

macOS

  1. Download the .dmg from Downloads.
  2. Open it and drag Cronos Wallet into Applications.
  3. If Gatekeeper warns you, click Open after verifying the developer.
  4. Launch via Spotlight or the Applications folder.

Linux

You may install a portable AppImage or a system package:

  • AppImage (portable)
    1. Download the .AppImage.
    2. chmod +x CronosWallet-x.y.z.AppImage
    3. ./CronosWallet-x.y.z.AppImage
  • .deb (Debian/Ubuntu)
    1. Download the .deb package.
    2. sudo apt install ./CronosWallet-x.y.z.deb
    3. Launch from the application menu.
  • .rpm (Fedora/RHEL)
    1. Download the .rpm package.
    2. sudo rpm -i CronosWallet-x.y.z.rpm
    3. Launch from your environment menu.
NOTE On hardened Linux systems certain sandboxing features or hardware wallets may require additional permissions. If unsure — begin with AppImage.

First run & wallet setup

After installation, Cronos Wallet walks you through onboarding where you can create a new wallet or import an existing one.

Create a new wallet

  1. Select Create new wallet on the welcome screen.
  2. Set a strong password for unlocking the app.
  3. Write down the generated seed phrase and store it offline.
  4. Confirm the phrase when prompted.
  5. Finish onboarding to access your wallet.

Import an existing wallet

  1. Choose Import wallet.
  2. Select seed phrase or private key import.
  3. Enter the data exactly as originally backed up.
  4. Set a new local password.
  5. Allow time for balances and activity to sync.
SECURITY Never enter your seed phrase on websites, pop-ups or browser extensions unrelated to Cronos Wallet. This is the only recovery method — keep it offline and private.

Choosing a network

Cronos Wallet connects to Mainnet by default. Developers and testers may prefer using Cronos Testnet first.

  • Open the network selector inside the app.
  • Switch between Mainnet and Testnet as needed.
  • Use public faucet sources to acquire test CRO.

For RPC details and chain configuration, visit Architecture or the broader Developer tutorials & resources.

Troubleshooting

The installer is blocked or flagged

  • Verify you downloaded from the official Downloads page.
  • Check file name and signature.
  • Compare checksums if provided.

The app does not start

  • Ensure your OS meets minimum requirements.
  • Restart your device and try again.
  • On Linux, run from terminal to view logs.

Balances do not show

  • Check that you’re on the correct network.
  • Verify you're using the expected address.
  • Wait a few blocks and refresh.

Still stuck? Check the FAQ or continue with the Developer tutorials & resources if you plan to deploy contracts or build dApps.