This document will guide you through the installation process of the latest tagged version of Thyra.
PREREQUISITES: Be comfortable with your terminal and have a recent version of MacOS, Windows or Linux.
TROUBLESHOOTING: If you have trouble following this procedure, feel free to open a question describing your problem.
Two steps are required to use our web on-chain product:
- Thyra installation : obtain the Thyra binary corresponding to your operating system (OS), rename it and make it executable.
- DNS configuration : install and configure your DNS to resolve the massa top level domain (*.massa) where Thyra runs.
You can either perform these two steps automatically, using an installation script, or manually using the binaries and command lines.
Now, let's move on to your OS section:
Simply use the link below to download and then open the file on your machine. The installation process will start and a success message will be displayed once done. Once the installation is finished, congratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!
Download and open the file here or or run the following cmd:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/massalabs/thyra/main/scripts/macos_install.sh)"Congratulation, your version of Thyra is now installed on your system and can be run by executing thyra-server in your terminal.
Let's start by downloading the version of Thyra corresponding to your system:
- If you have an Intel CPU (amd64), you can download your executable here.
- If you have an Intel Apple Silicon CPU M1, M1 Pro, M2... (arm64), you can download your executable here.
Next, let's rename and make the downloaded binary executable by running the following command in your terminal:
mv thyra-server* thyra-server && chmod +x ./thyra-serverNOTE: These commands should be executed directly from the directory where Thyra was downloaded.
Congratulation, your version of Thyra is now installed on your system and can be run by executing ./thyra-server in your terminal.
NOTE: If your DNS is already configured to handle the massa TLD, you're free to go. Otherwise, please follow the instructions in the next section.
WARNING: If you already have a DNS service running that is not dnsmasq, you must configure it to redirect .massa to 127.0.0.1 (localhost).
PREREQUISITE: Have
homebrewalready installed on your system. If not, you can follow the installation instructions here.
Let's start by installing dnsmasq. This step can be safely skipped if it is already installed on your system.
brew install dnsmasqNext, let's configure it to redirect .massa request to locahost:
echo 'address=/.massa/127.0.0.1' >> $(brew --prefix)/etc/dnsmasq.d/massa.conf
sudo mkdir -p /etc/resolver
sudo bash -c 'echo "nameserver 127.0.0.1" >> /etc/resolver/massa'
echo "Now we need you to type in your password to start the dnsmasq service."
sudo brew services start dnsmasqCongratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!
Simply use the link below to download and then open the file on your machine. The installation process will start and a success message will be displayed once done. Once the installation is finished, congratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!
Open and use this file here or run the following cmd:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/massalabs/thyra/main/scripts/linux_install.sh)"Congratulation, your version of Thyra is now installed on your system and can be run by executing thyra-server in your terminal.
NOTE: Only Linux Ubuntu is currently supported.
Let's start by downloading the version of Thyra corresponding to your system here.
Next, let's rename and make the downloaded binary executable by running the following command in your terminal:
mv thyra-server* thyra-server && chmod +x ./thyra-serverNOTE: These commands should be executed directly from the directory where Thyra was downloaded.
Congratulation, your version of Thyra is now installed on your system and can be run by executing thyra-server in your terminal.
NOTE: If your DNS is already configured to handle the massa TLD, you're free to go. Otherwise, please follow the instructions in the next section.
WARNING: If you already have a DNS service running that is not dnsmasq, you must configure it to redirect .massa to 127.0.0.1 (localhost).
NOTE: If you have
NetworkManagerrunning, you must change its configuration to usednsmasqas your local DNS. You can do this by running the following command:sudo cp /etc/NetworkManager/NetworkManager.conf /etc/NetworkManager/NetworkManager.conf_backup_thyra_install && sudo sed -i "s/keyfile/keyfile\ndns=dnsmasq/g" /etc/NetworkManager/NetworkManager.confThis command backs up
/etc/NetworkManager/NetworkManager.conffile to/etc/NetworkManager/NetworkManager.conf_backup_thyra_install.
Then we must configure and restart the dnsmasq service:
sudo mkdir -p /etc/NetworkManager/dnsmasq.d/
echo "address=/.massa/127.0.0.1" | sudo tee -a /etc/NetworkManager/dnsmasq.d/massa.conf > /dev/null
sudo mv /etc/resolv.conf /etc/resolv.conf_backup_thyra_install && sudo ln -s /var/run/NetworkManager/resolv.conf /etc/resolv.conf
sudo systemctl restart NetworkManagerNOTE: your
/etc/resolv.conffile has been backed up to/etc/resolv.conf_backup_thyra_install.
Congratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!
Simply use the link below to download and then open the file on your machine. The installation process will start and a success message will be displayed once done. Note that you must execute this script as an administrator. Once the installation is finished, congratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!
Open and use this file here or run the following cmd:
curl -fsSL https://raw.githubusercontent.com/massalabs/thyra/main/scripts/thyra-installer.bat >> thyra-installer.bat && thyra-installer.batCongratulation, your version of Thyra is now installed on your system and can be run by executing thyra-server in your terminal.
Let's start by downloading the version of Thyra corresponding to your system here.
Next, you must rename it to thyra-server.exe.
Congratulation, your version of Thyra is now installed on your system and can be run by executing thyra-server.
NOTE: If your DNS is already configured to handle the massa TLD, you're free to go. Otherwise, please follow the instructions in the next section.
WARNING: If you already have a DNS service running that is not dnsmasq, you must configure it to redirect .massa to 127.0.0.1 (localhost).
PREREQUISITE: Have
Acrylicalready installed on your system. If not, you can follow the installation instructions here and the OS configuration here.
Let's start by configuring acrylic to redirect *.massa to locahost:
-
Open Acrylic config file: Open Acrylic DNS Proxy UI > File > Open Acrylic Hosts
-
Add
*.massatop level domain toAcrylicHosts.txt:
127.0.0.1 *.massa- Save the file and reload Acrylic: Open Acrylic DNS Proxy UI > Actions > Restart Acrylic Service
Congratulations, you can now browse the websites on-chain seamlessly. If you need to take the pressure off, maybe a little game can help. If you want to get down to business, you can start your Massalian journey right away!