How can we help?

The PrismNS agent is a lightweight TCP client that connects to our server and automatically registers your host's IP address. To install:

1. Log in to your dashboard and navigate to Hosts.
2. Click Add Host and copy your automation API token.
3. Download the agent binary for your platform from the dashboard or the releases page.
4. Run the agent with your server address and API token: prismns-agent --token YOUR_TOKEN
5. Your host will appear as online in the dashboard within a few seconds.

The agent can be run as a systemd service for automatic startup. Sample unit files are available in the documentation linked from your dashboard.

To use your own domain with PrismNS:

1. Go to DNS Zones in the dashboard and click Add Zone.
2. Enter your domain name (e.g. example.com) and click Create.
3. PrismNS will provide you with nameserver addresses. Update your domain registrar's NS records to point to these nameservers.
4. Once DNS propagates (typically 1–48 hours), your zone is active and PrismNS agents will create records under it automatically.

You can assign specific hosts to your zone from the Hosts page by editing the host's zone assignment.

A host is marked offline when the PrismNS server stops receiving heartbeat signals from the agent. Common causes:

Agent not running: Check that the agent process is active on your server. If running as a systemd service, try systemctl status prismns-agent and journalctl -u prismns-agent to view logs.

Network connectivity: Verify your server can reach the PrismNS TCP endpoint. Firewalls or outbound connection restrictions can block the agent.

Token expired or revoked: If you recently rotated your API token, make sure the agent is configured with the new token and has been restarted.

If the host was genuinely offline and has reconnected, the dashboard should update to online status within one heartbeat interval (default 60 seconds).

API tokens are managed from Settings → Automation Tokens in the dashboard.

To create a new token, click Generate New Token, give it a name, and copy the token value — it is only shown once.

To rotate a token: generate a new one, update all agents and integrations using the old token, then delete the old token from the dashboard. Agents will need to be restarted after updating their token configuration.

If you believe a token has been compromised, delete it immediately from the dashboard. The token will be invalidated instantly.

You can cancel your subscription at any time from Settings → Billing. Click Cancel Subscription and confirm.

Your subscription remains active until the end of the current billing period — you won't lose access immediately. After expiry, your account will be downgraded to the free tier (if available) and any features exceeding the free tier limits will be disabled.

If you have questions about your bill or believe you were charged incorrectly, email support@prismns.com with your account email and we'll sort it out.

Account deletion can be initiated from Settings → Account → Delete Account. You will be asked to confirm by entering your password.

Deleting your account will permanently remove all your DNS zones, host records, API tokens, and personal data within 30 days. Billing records may be retained for up to 7 years for legal compliance — see our Privacy Policy for details.

This action is irreversible. Make sure to export any DNS configurations you want to keep before deleting. If you need help exporting your data first, contact support@prismns.com.