Your domains, one command away
The namefi CLI keeps a machine reachable by name. It updates DNS the moment the network changes, lists what you own, and asks the router to open the ports you need.
curl -fsSL https://namefi.io/cli/setup.sh | sh- macOS, Linux, Windows
- one static Go binary, no runtime to install
- Event-driven
- reacts to network changes instead of polling on a timer
- Browser login or API key
- every command runs as a credential you control
Three jobs, one binary
Built for the machine under your desk as much as the server in a rack.
Dynamic DNS that keeps up
Your portfolio in the terminal
Port forwarding through NAT
From install to a live record
Four commands. The daemon takes over from there.
- 1
Install the binary
Downloads the release for your platform and puts namefi on your path.
curl -fsSL https://namefi.io/cli/setup.sh | sh - 2
Sign in
Opens your browser and stores the session in the OS keyring. On a machine with no browser, use namefi login --device instead.
namefi login - 3
Check what you own
Confirms the credential works and shows the domains it can reach.
namefi domains list - 4
Point a hostname at this machine
Store the scoped Dynamic DNS credential you created in the dashboard, then start the daemon.
namefi dyndns creds set namefi dyndns run
The daemon writes only after a confirmed change and never deletes a record when an address family goes missing.
Common commands
The ones you reach for most. Authentication lives at the top level; dynamic DNS is one command group under it.
Sign in and out
- namefi login
- namefi login --device
- namefi logout
The browser login renews itself. The device flow is for headless hosts and ends when the session expires.
See the active credential
- namefi status
Prints which credential wins and where it came from, so precedence is never a guess.
List your domains
- namefi domains list
Supports --long, --json, --names-only, --search, --expiring-in, --ns, --parked, and --sort. Needs an account credential.
Keep records current
- namefi dyndns run
- namefi dyndns update
- namefi dyndns check
run is the daemon, update pushes once and exits, and check resolves and diffs without writing anything.
Manage the scoped credential
- namefi dyndns creds set
- namefi dyndns creds show
- namefi dyndns creds clear
Stores a Dynamic DNS username and secret in the OS keyring. show never prints the secret.
Forward ports
- namefi dyndns run --map 443/tcp
- namefi dyndns run --map 8443:443/tcp
Ask the router for a forward, optionally remapping the external port. Add --map to check to diagnose without writing.
Run `namefi --help` for the rest, or browse the full reference
Pick the credential that matches the machine
A laptop you sit at and an unattended daemon want different things.
Browser login
API key
Recommended for an unattended daemon
Create a Dynamic DNS credential in Domain settings and store it with namefi dyndns creds set. It does not expire and it can change one hostname instead of your whole account, so a compromised machine cannot touch the rest of your portfolio.
Open Domain settingsWhen more than one is present the scoped Dynamic DNS credential wins, then the API key, then the stored login. namefi status shows which one is in use.
Install it and go
One line to install, one login, and your hostname follows the machine.
curl -fsSL https://namefi.io/cli/setup.sh | sh