Pi Node for DS-Lite Users
Here is a detailed step-by-step guide for operating a Pi Node under Windows with a DS-Lite and IPv6 connection. This guide helps you to successfully operate a Pi Node, even if you are working in a DS-Lite environment with IPv6. The process is optimized for physical Windows installations.
Requirements:
- Windows 10 x64 (Home or higher, in the latest version)
- Internet connection with Dual-Stack-Lite (DS-Lite) and IPv6
- VServer (VPS) with Linux Root rights (from 1,- Euro/month)
- Pi Node Software (latest version 0.5.1)
- WireGuard Software (latest version)
- Docker Desktop Software
- PuTTY (SSH Client)
Important Note: Installation and use on virtual machines (VMs) is not supported. This guide is intended exclusively for Windows installations on physical machines.
1. Preparation of the Client
Download required software:
- Pi Network Node Software:
- Linux Kernel Update Package for Windows:
- Docker Desktop Software (4.39):
- WireGuard Software for Windows:
- PuTTY (SSH Client):
Important Note: Always download software only from official sources to ensure the security of your system.
2. Firewall Configuration in Windows
Open Ports in the Windows Firewall:
- Press Windows key + R and enter firewall.cpl.
- Click on Advanced Settings.
- Create a new rule for Incoming Rules and open the TCP ports 31400 to 31409.
- Repeat the process for Outgoing Rules to open the same ports.
- Close all windows.
Alternatively, you can also use the following batch file to open the ports automatically:
3. WireGuard Client Configuration
Install the WireGuard Windows client and start it.
Click on "Add Tunnel" and select "Add an empty tunnel".
Copy the public and private key from the window and note them down, as you will need them later.
4. WireGuard Server Installation on the VPS
Connect to the server:
Open PuTTY and enter the IP address or domain of your VPS. Click on "Open" to establish the connection.
Obtain root rights:
After logging in, enter the command sudo su to obtain root rights.
Update system and install WireGuard:
Run this command to update the system, download the script and unpack it:
Für IPv4-Only Server:
apt update && apt-mark hold openssh-server && apt upgrade -y && apt install -y unzip && wget https://pi-network-info.de/download/iwireguard.zip && unzip iwireguard.zip && apt-mark unhold openssh-server && sed -i 's/\r//' install_wireguard.sh && chmod +x install_wireguard.sh
oder
Für IPv4 + IPv6 Server:
( better Incoming connections)apt update && apt-mark hold openssh-server && apt upgrade -y && apt install -y unzip && wget https://pi-network-info.de/download/iwireguardplusipv6.zip && unzip iwireguardplusipv6.zip && apt-mark unhold openssh-server && sed -i 's/\r//' install_wireguard.sh && chmod +x install_wireguard.sh
Start the script with:
sudo ./install_wireguard.sh
During the execution of the script, enter the public and private key of the WireGuard client.
Copy configuration:
After successful execution of the script, copy the content of the file /etc/wireguard/client1.conf and paste it into the WireGuard client configuration file on your Windows client.
Activate WireGuard:
Click on Activate to start the connection.
(Only for Ipv6) Configure Autostart after Restart:
To ensure that the WireGuard service automatically sets IPv6 correctly after each restart / internet connection problem, run the following command:
sudo apt update && sudo apt-mark hold openssh-server && sudo apt upgrade -y && sudo apt install -y wget && sudo wget https://pi-network-info.de/download/fix-ipv6.sh -O /usr/local/bin/fix-ipv6.sh && sudo chmod +x /usr/local/bin/fix-ipv6.sh && sudo sed -i 's/\r//' /usr/local/bin/fix-ipv6.sh && sudo /usr/local/bin/fix-ipv6.sh && sudo apt-mark unhold openssh-server
During the execution of the script, enter your server's IPv6 address when prompted. This step ensures that your VPS restores the WireGuard connection correctly after a restart.
5. Pi Node & Docker Desktop Installation for Windows
Activate Windows Subsystem for Linux (WSL):
Open the command prompt with administrator rights and enter the following commands:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Important Note: Restart the PC.
Install Linux Kernel Update:
Install the Linux Kernel Update for Windows.
Install Docker Desktop:
Install the previously downloaded Docker Desktop Software (accept only the license agreement).
Important Note: After installing Docker Desktop, start it once and then you must restart your PC before continuing!
Install Pi Node Software:
Now install the Pi Node Software.
Restart the PC if necessary.
6. VServer and Web Interface
If your VServer provider provides a web interface, you may also need to release the corresponding ports (31400 to 31409) in this interface. Check this in the settings of your VPS.
7. Troubleshooting
WireGuard connection does not work:
- Check if all ports are open in the firewall.
- Make sure your VPS is configured correctly and that you have entered the correct keys in the configuration.
Pi Node does not start:
- Check if Docker is installed correctly and all required services are running.
- Make sure all steps have been followed exactly and that your PC has been restarted.
If you have any questions, just write to the chat!