Skip to content

Installation

Jump to bottom
Nathan Seva edited this page Oct 31, 2022 · 14 revisions

This latest installation process is described here: https://github.com/massalabs/thyra/blob/main/INSTALLATION.md

Installation

Currently, Thyra can be installed using prebuilt binaries. We might support other installation process later.

MacOS

  1. Download the MacOS binary corresponding to your system in the asset section of the latest Release.

Note: if you are using an Intel CPU, you need to download the amd64 version, if you have an Apple Silicon CPU (M1, M1 Pro, M2...) you need to download the arm64 version.

  1. Install dnsmasq using Homebrew. If Homebrew isn't installed on your computer, install it using the instructions available here.
  • Open a terminal and run the following command:
brew install dnsmasq

From there, paste below cmd on your terminal.

  1. Create dnsmasq config for *.massa 
echo 'address=/.massa/127.0.0.1' >> $(brew --prefix)/etc/dnsmasq.d/massa.conf
  1. Add your nameserver to resolvers
sudo mkdir -p /etc/resolver
sudo bash -c 'echo "nameserver 127.0.0.1" > /etc/resolver/massa'
  1. Restart dnsmasq 
sudo brew services start dnsmasq
  1. Get in the directory you downloaded Thyra and run the following command:

For a Mac with an Intel CPU:

chmod +x ./thyra-server_darwin_amd64

And for a Mac with an Apple Silicon CPU:

chmod +x ./thyra-server_darwin_arm64
  1. Start Thyra using the binary you downloaded in step 1

For a Mac with an Intel CPU, it should be:

./thyra-server_darwin_amd64

And for a Mac with an Apple Silicon CPU, it should be:

./thyra-server_darwin_arm64

You now should be able to access Thyra using your web browser at http://my.massa/thyra/wallet/index.html. In case of error, feel free to open an issue describing your problem.

Linux

Disclaimer

For now, this installation process has been tested on Ubuntu 22.04 and might not work on other distribution. Feel free to open an issue describing your problem if you face any.

Ubuntu

  1. Download the Linux binary from the asset section of the latest Release.

  2. Replace the used DNS by NetworkManager to use dnsmasq

sudo sed -i "s/keyfile/keyfile\ndns=dnsmasq/g" "/etc/NetworkManager/NetworkManager.conf"
  1. Make sure dnsmasq configuration directory exist
sudo mkdir -p "/etc/NetworkManager/dnsmasq.d/"
  1. Create dnsmasq config for *.massa 
echo "address=/.massa/127.0.0.1" | sudo tee /etc/NetworkManager/dnsmasq.d/massa.conf > /dev/null
  1. Update /etc/resolv.conf simlink to use NetworkManager 
sudo rm "/etc/resolv.conf"
sudo ln -s "/var/run/NetworkManager/resolv.conf" "/etc/resolv.conf"
  1. Restart NetworkManager
sudo systemctl restart NetworkManager
  1. Get in the directory you downloaded Thyra and run the following command:
chmod +x ./thyra-server_linux_amd64
  1. start Thyra using the binary you downloaded in step 1
./thyra-server_linux_amd64

If you get the following error: listen tcp :80: bind: permission denied, you might need to run the previous command as sudo or change the http port using the -http-port and https port using the -https-port arguments.

You now should be able to access Thyra using your web browser at http://my.massa/thyra/wallet/index.html. In case of error, feel free to open an issue describing your problem.

Windows

  1. Download the Windows binary from the asset section of the latest Release.

  2. Install Acrylic

  3. Configure Acrylic DNS Proxy

  4. Open Acrylic config file: Open Acrylic DNS Proxy UI > File > Open Acrylic Hosts

  5. Add *.massa top level domain to AcrylicHosts.txt:

127.0.0.1   *.massa

Make sure to save using CTRL+S.

  1. Restart Acrylic: Open Acrylic DNS Proxy UI > Actions > Restart Acrylic Service

  2. Start Thyra by executing the binary you downloaded during step 1

You now should be able to access Thyra using your web browser at http://my.massa/thyra/wallet/index.html. In case of error, feel free to open an issue describing your problem.

Clone this wiki locally