DNS Setup
NuFi uses fixed hosts such as dashboard.nufi.com and api.nufi.com together with dynamic hosts created per Serving. After installation, configure local DNS on the client PC so those domains resolve to the NuFi server IP.
This configuration is performed on the client PC that will access NuFi, not on the NuFi server.
Prerequisites
Before you start, prepare the following information.
| Item | Description | How to check |
|---|---|---|
| NuFi server IP | IP of the server (master node) where NuFi is installed | Run ip addr show on the server |
| Network connectivity | Client can reach the NuFi server | ping <server IP> |
If ping fails, check that both machines are on the same network and review firewall settings.
Run the Client Script
Use wildcard mode to access dynamically generated Serving endpoints.
macOS/Linux:
curl -LsSf https://docs.nufi.me/install/nufi-access.sh | sudo bash -s -- --mode wildcard --base-domain <domain> <NuFi server IP>
Windows PowerShell:
Run PowerShell as Administrator. If Chocolatey is not installed, install it first with the command below.
powershell -NoProfile -ExecutionPolicy Bypass -Command "if (-not (Get-Command choco -ErrorAction SilentlyContinue)) { iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) }"
Then run the access setup script.
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://docs.nufi.me/install/nufi-access.ps1))) -Mode wildcard -BaseDomain <domain> -NodeIp <NuFi server IP>"
Verify Access
Open the dashboard in a browser.
http://dashboard.<domain>
Dynamic Serving endpoints use the same base domain.
http://<generated-endpoint>.<domain>
Cleanup
When the DNS configuration is no longer needed, run cleanup.
macOS/Linux:
curl -LsSf https://docs.nufi.me/install/nufi-access.sh | sudo bash -s -- cleanup --mode wildcard --base-domain <domain>
Windows PowerShell:
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://docs.nufi.me/install/nufi-access.ps1))) cleanup -Mode wildcard -BaseDomain <domain>"