Skip to main content

Manual Install

caution

Disclaimer​

This guide is intended for advanced users who are familiar with the command line and system administration.

Installation​

If you are unable to install Massa Station using the methods described in the Installation section, or simply prefer to install it manually, you can follow these steps:

  1. Download the latest version of the Massa Station binary for your operating system from here.
    caution

    Make sure to download the binary for your operating system and architecture.
    For example, if you are using Windows 10 on a 64-bit machine, you should download the massastation_windows_amd64 file.
    On Apple Silicon (M1, M2...) Macs, you should download the massastation_darwin_arm64 file, while Intel Macs should download the massastation_darwin_amd64 file.

  2. Put the downloaded binary in a directory of your choice.
  3. On MacOS and Linux:
    3.1. create the Massa Station data directory:
    mkdir -m 777 -p /usr/local/share/massastation
    3.2. Add executable permissions to the binary:
    chmod +x massastation_$OS_$ARCH
    3.3. Move the binary to /usr/local/bin:
    mv massastation_$OS_$ARCH /usr/local/bin/massastation
  4. Run the binary to start Massa Station.
  5. Open your browser and navigate to http://localhost/ to access Massa Station.

This method of installation will not install the necessary dependencies for Massa Station to function correctly and so, features such as HTTPS support and accessing .massa domains will not work.

Handle station.massa redirection​

If you want to access Massa Station by typing station.massa in your browser's address bar, you will need to configure your system to redirect requests to station.massa to localhost. You can make this change by editing the 'hosts' file on your computer, regardless of whether you're using Windows, MacOS, or Linux:

  1. Open the 'hosts' file, which is located at:
    • Windows: C:\Windows\System32\drivers\etc\hosts
    • MacOS and Linux: /etc/hosts
  2. Add 127.0.0.1 station.massa at the end of the file.
  3. Save and close the file.

Add HTTPS support​

Massa Station will automatically generate a self-signed certificate for HTTPS support when it is first run, but to do it, it requires some dependencies to be installed on your system.

Windows​

  1. Download a Windows version of the Mar Tools
  2. Extract the contents of the archive to a directory named mar-tools in the same directory as the massastation.exe binary.
  3. Run the massastation.exe binary to start Massa Station.

MacOS​

  1. Install Homebrew.
  2. Install the nss package using Homebrew: brew install nss
  3. Create the certificate directory:
    mkdir -m 777 -p /etc/massastation/certs
  4. Run the massastation binary in repair mode with sudo:
    sudo ./massastation --repair
  5. Run the massastation binary to start Massa Station.

Linux​

  1. Install the nss package using your package manager.
  2. Create the certificate directory:
    mkdir -m 777 -p /etc/massastation/certs
  3. Run the massastation binary to start Massa Station.