On Board
Welcome to LooPIN! Ready to dive into decentralized computing? Let's get you set up in just 5 minutes.
1. System Requirements
Before you get started, ensure you meet the following requirements:
- A stable network connection and open ports for cluster access
- An Ubuntu system with Nvidia GPUs installed, as currently, LooPIN only supports this configuration
- Ubuntu 22.04 LTS is recommended
2. Installation Process
A. Initial Setup
- Register on LooPIN: Head over to loopin.network and sign up using your email or Google account.
- Prepare Your Machine: Ensure you have a bare metal machine with an Nvidia GPU. Navigate to the "server" section on the navbar and click on "Deploy a new machine".
B. CLI Worker Registration
- Open a terminal on your Ubuntu system.
- Run the following command to register your machine as a LooPIN worker (Find it in your guidance page):
curl -fsSL https://files.loopin.network/install.sh | sudo bash -s -- --code <your-unique-code> --ip <your-ip>
This command downloads and executes the LooPIN installation script, registering your machine with the provided unique code. (Optional) You can also provide your machine's IP address—usually, the script auto-detects it.
C. Verification
The script will check if your machine meets the requirements and will install necessary drivers, including the Nvidia GPU driver. It will then verify your setup and register your worker. Upon successful installation, you should see the message:
LooPIN Client Connected! Waiting for the on-chain verification...
This indicates that the client application is installed and awaiting connection. The first-time connection may take approximately 5-10 minutes, depending on your network speed.
3. Post-Installation Checks
A. Worker Status Check
When you see "ok connected on port 9789," immediately check the worker status:
sudo systemctl status loopin-worker.service
If it shows error EOF, restart it immediately:
sudo systemctl restart loopin-worker.service
B. Host Configuration
Ensure your /etc/hosts
file contains:
159.69.58.107 easzlab.io.local
You can verify this using:
cat /etc/hosts
- No reboot is needed to apply this change
- This needs to be checked at each installation or reinstallation of LooPIN
- If you use HiveOS, note that HiveOS resets the
/etc/hosts
file on every reboot
C. Monitoring Commands
You can use these commands to detect potential issues:
sudo journalctl -u containerd -n 5 -f
sudo journalctl -u kubelet -n 5 -f
sudo journalctl -u loopin-worker -n 5 -f
4. Uninstallation Process
If you need to remove LooPIN from your system, follow these steps:
- (Optional) Download the loopin executable if you don't have it:
curl -fsSL https://files.loopin.network/loopin -o loopin && chmod +x loopin
- Run the uninstallation command:
sudo ./loopin --uninstall
What the Uninstallation Does
The uninstallation process will:
- Delete the LooPIN controller access
- Remove the loopin-worker from your system
You should see output similar to:
Uninstalling LooPIN components...
Removed LooPIN controller access
Removed /etc/systemd/system/multi-user.target.wants/loopin-worker.service.
Stopped and removed LooPIN worker service.
Removed LooPIN worker executable.
👋 LooPIN has been successfully uninstalled from your system.