NODE

INSTALLATION

The following platform was used to test Sun on:

  • Windows 10 x64
  • Ubuntu 22.04 LTS
  • MacOS Catalina (10.15.7) x64

Others should work too; check this page for all platforms supported by .NET 6.0 Runtime

WINDOWS

1. Unpack downloaded archive to any empty folder on a disk.

2. If needed, download and install .NET 8.0 Runtime

3. If you are going to run a nexus, configure Etherem API Privider in C:\Users\{Current User}\AppData\Roaming\UO.Sun\Testzone1\Sun.settings file

4. Open firewall settings and allow incoming connections for TCP port 3801.

5. Run "sun.exe node run peer" command to connect to the network, or run Sun.FUI.exe executable to launch a node with graphical UI.

LINUX (Ubuntu 22.04 LTS)

1. Install dotnet 8.0

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update \
&& sudo apt-get install apt-transport-https -y \
&& sudo apt-get update \
&& sudo apt-get install dotnet-runtime-8.0 dotnet-sdk-8.0 -y

2. Install additional dependencies

sudo apt-get install libsnappy-dev unzip libc6-dev -y

3. Create 'sun' directory

sudo mkdir -p /usr/lib/sun/ && cd /usr/lib/sun

4. Download the latest Sun distribution package.

sudo wget https://www.ultranet.org/download/sun-Linux-Latest.zip

5. Extract the distributive archive.

sudo unzip sun-Linux-Latest.zip

6. Run the node and connect to the network

/usr/bin/dotnet /usr/lib/sun/Sun.dll node run peer

MACOS

1. Download and install the latest .NET 8.0 Runtime and SDK using link1, link2 on macOS 10.13+, x64

curl https://download.visualstudio.microsoft.com/download/pr/2dc0cd09-9e3d-4329-b01b-12b417e610de/38a37e5f8b93ef55e6630f216265293a/dotnet-runtime-8.0.1-osx-x64.pkg -o dotnet-runtime-8.0.1-osx-x64.pkg
sudo installer -pkg dotnet-runtime-8.0.1-osx-x64.pkg -target /
curl https://download.visualstudio.microsoft.com/download/pr/3b11b408-68e1-4a8f-a0ad-55b21456c4f6/03819d38c79a9aa4fd806f8c7b64130d/dotnet-sdk-8.0.101-osx-x64.pkg -o dotnet-sdk-8.0.101-osx-x64.pkg
sudo installer -pkg dotnet-sdk-8.0.101-osx-x64.pkg -target /

2. Download the latest SUN archive, extract and set up permissions:

curl https://www.ultranet.org/download/sun-MacOS-Latest.zip -o sun-macOS-Latest.zip
sudo unzip sun-macOS-Latest.zip -d /usr/local/sun
sudo chown -R $USER /usr/local/sun

3. Run the node and connect to the network

/usr/local/share/dotnet/dotnet /usr/local/sun/Sun.dll node run peer

Docker

The following platform was used to test SUN docker container:

  • Windows 11 x64 WSL2
  • Ubuntu 22.04 LTS
  • MacOS Catalina (10.15.7) x64

Docker is a common container runtime that will easily run Ultranet software. If you are running Linux, ensure you have installed the Docker Engine. If you are running Window or MacOS be free to install Docker Desktop for Windows, MacOS respectively.

The latest Node Sun container will be pulled out and installed at the first its run by the command:

docker run -ti --rm -v ${HOME}:/root mightywill/sun:latest node run peer