Wwwnephaelnet Install

To avoid downloading malicious binaries, always use the official script or GPG keys.

Linux (Automatic Script):

curl -fsSL https://wwwnephaelnet.io/install.sh | sudo bash

Wait for the GPG key import confirmation.

Linux (Manual Repository):

echo "deb [signed-by=/usr/share/keyrings/nephaelnet-archive-keyring.gpg] https://wwwnephaelnet.io/deb stable main" | sudo tee /etc/apt/sources.list.d/nephaelnet.list
sudo curl -fsSL https://wwwnephaelnet.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nephaelnet-archive-keyring.gpg
sudo apt update

Windows: Download the MSI installer directly from https://wwwnephaelnet.io/download/windows/nephaelnet-latest.msi. Run as Administrator. wwwnephaelnet install

macOS:

brew tap nephaelnet/tap
brew install nephaelnet

The wwwnephaelnet install script relies heavily on containerization.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
newgrp docker

Verify installation:

docker --version
docker compose version

If you need to perform a clean reinstall or remove the software: To avoid downloading malicious binaries, always use the

Linux:

sudo apt remove --purge nephaelnet   # Debian/Ubuntu
sudo dnf remove nephaelnet           # RHEL/Fedora
sudo rm -rf /etc/nephaelnet /var/log/nephaelnet

macOS:

brew uninstall nephaelnet

Windows: Use "Add or Remove Programs" and delete %ProgramData%\Nephaelnet.

To remove a NephaelNet installation:

wwwnephaelnet uninstall --purge

This stops services, removes containers, deletes /etc/nephaelnet and /var/lib/nephaelnet, and removes systemd units (but leaves Docker installed).

| Error | Cause | Fix | |-------|-------|-----| | kernel: wireguard not found | Missing WireGuard module | sudo apt install wireguard / sudo modprobe wireguard | | port 8443 already bound | Conflict with existing service | Change UI port in /etc/nephaelnet/config.yaml | | image pull timeout | Slow or restricted network | Run wwwnephaelnet install --airgap with local images | | failed to start service | SELinux blocking binary | sudo setenforce 0 (or adjust policy) |

Cause: The installer did not add the binary to PATH.
Fix: Manually add C:\Program Files\Nephaelnet\bin to your System Environment Variables and restart PowerShell.