Skip to main content

Install

System Requirements

  • Operating System:
    • Windows 10 and 11
    • MacOS 13 and above
    • Debian-based Linux distributions: Ubuntu 22.04 and later, Debian 11 and later...
  • Disk Space: At least 200 MB
  • RAM: At least 2 GB
  • Web Browser: Firefox or Chromium-based browsers (Chrome, Brave, etc.)

To install Massa Station, follow these steps:

  1. Visit the Massa Station website.
  2. Click the Download button and select the version compatible with your operating system.
  3. Once the download is complete, run the installer and follow the instructions.
info

During the installation process, you will be prompted to grant permissions to Massa Station. These permissions are necessary for Massa Station to function correctly.

note

If you prefer to install Massa Station manually, you can follow the instructions provided in the Manual Install section.

Windows

  1. Locate the downloaded .msi installer file and double-click on it to start the installation process.
  2. Follow the on-screen instructions to proceed with the installation.
  3. You will be prompted to choose the kind of installation you want. We recommend choosing the "Complete" installation as it will install all the necessary dependencies to access web on-chain. If you select the "Typical" option, Massa Station will be installed without DNS configuration. In that case, access to .massa domains may be restricted.
  4. Once the installation is complete, you can launch Massa Station from the Start menu.
  5. If prompted, click on "Yes" to allow the installer to make changes on certificates. These certificates allow Massa Station to use the HTTPS protocol, which improves your security when browsing dApp.
info

If you experience any issues during the installation process or while using Massa Station, please refer to the FAQ.

caution

If you are using a version of Massa Station older than 0.3.6, Windows will warn you about untrusted software. You can safely ignore this warning and proceed with the installation by clicking on "more info" and "run anyway".

MacOS

  1. Locate the downloaded .pkg installer file. Hold "Option" key on the keyboard and right-click on the package, at the same time.
  2. From the context menu, select "Open" and then click "Open" again in the security pop-up window. This step is necessary because the installer is not signed by the App Store, and MacOS may block the installation by default.
  3. If prompted, enter your administrator password to authorize the installation.
  4. Follow the on-screen instructions to proceed with the installation.
info

If you experience any issues during the installation process or while using Massa Station, please refer to the FAQ.

Debian Linux

On Linux, it is highly recommended to install Massa Station using a terminal, following the instructions below.

  1. Locate the downloaded .deb installer file.

  2. Open a terminal on your Debian Linux system.

  3. Navigate to the directory where the downloaded .deb package is located.

  4. Run the following command to install the package:

    sudo apt install ./massastation-VERSION_amd64.deb
  5. Enter your administrator password when prompted and press Enter to confirm.

  6. The installation will begin, and you will see progress information in the terminal.

  7. Ubuntu prior to 24.04 Only: Massa Wallet requires the libwebkit2gtk-4.1-0 package to be installed. Run the following command to install it:

    sudo apt install libwebkit2gtk-4.1-0

Once the installation is complete, you can close the terminal.

info

If you experience any issues during the installation process or while using Massa Station, please refer to the FAQ.

Updating on Linux

Once Massa Station is installed, you can update it using the same method as for the installation, or using the GUI:

  1. Open your file manager and navigate to the location where the .deb package is saved.
  2. Right-click on the .deb package and choose "Open with Software Install" or a similar option.
  3. The package manager will launch and display Massa Station installation page.
  4. Review the package information and dependencies, if any, and click on the "Install" button.
  5. If prompted, enter your administrator password to authorize the installation.
  6. The installation will commence, and you will see a progress bar indicating the status.
  7. Once the installation is complete, you will receive a notification confirming the successful installation.
info

If you experience any issues during the update, please refer to the FAQ.

Important information

There is a known issue involving version checks while updating Massa Station via the GUI. To avoid this issue we recommend following these instructions:

  1. Download the latest version of Massa Station installer for Debian Linux (.deb) from here.
  2. Open your file manager and navigate to the location where the .deb package is saved.
  3. The package manager will launch and display Massa Station installation page.
  4. Review the package information and dependencies, if any, and click on the red "Delete" button.
  5. Proceed to GUI update starting at step 2.