NovaDNS/Docs

Search documentation

Search for a page in the NovaDNS docs

HomepageDashboard

Guides

Teams

Teams let you collaborate on hosts, groups, and webhooks with other people under a shared workspace. Each team has its own plan, billing, and member roles — completely separate from your personal account.

Workspaces

Every NovaDNS account has a personal workspace by default. Your personal workspace is private — only you can see and manage its hosts, groups, and webhooks.

Teams are shared workspaces. When you create or join a team, it appears alongside your personal workspace in the workspace switcher in the top-left corner of the dashboard. Clicking a workspace name switches the entire dashboard to that context — all lists, settings, and actions apply only to the active workspace.

Resources are never shared between workspaces. A host created in your personal workspace cannot be seen or managed by team members, and vice versa, unless you explicitly transfer it.

The active workspace is remembered per browser session. If you manage both a personal account and a team, double-check the workspace switcher before making changes to avoid editing the wrong workspace.

Creating a team

Any account on a paid personal plan can create a team. Teams have their own plan and billing that are separate from the creator's personal plan.

  1. Click the workspace switcher in the top-left corner of the dashboard.
  2. Select New team from the dropdown.
  3. Enter a team name. This is displayed to all members and in billing receipts.
  4. Confirm — you are immediately set as the team Owner and taken into the new workspace.

After creation the team starts on a free trial. Navigate to Settings → Billing within the team workspace to select a plan before the trial ends.

Creating a team requires a paid personal plan. If your personal account is on the Free tier, upgrade it first from your personal workspace billing settings.

Inviting members

Owners and Admins can invite new members. Invitations are sent by email and expire after 7 days if not accepted.

  1. Switch to the team workspace using the workspace switcher.
  2. Navigate to Team in the sidebar.
  3. Click Invite member.
  4. Enter the invitee's email address and select their role.
  5. Click Send invite — they receive an email with an accept link.

The invitee clicks the link in the email, which takes them to novadns.io/invite/[token]. If they do not already have a NovaDNS account, they are prompted to create one before accepting. Once accepted, the team workspace appears in their workspace switcher immediately.

Pending invites are listed on the Team page. An Owner or Admin can cancel an invite before it is accepted by clicking the trash icon next to the pending entry.

Roles

Every team member is assigned one of three roles. Roles control what actions a member can perform within the team workspace.

RolePermissions
Owner
  • All Admin permissions
  • Manage team billing and plan
  • Transfer or delete the team
  • Promote members to Admin or Owner
Admin
  • Create, edit, and delete hosts, groups, and webhooks
  • Invite new members and set their role (up to Admin)
  • Remove members from the team
  • View and copy host credentials
Member
  • View all hosts and their current IPs
  • Use group credentials to update hosts (read credentials, cannot rotate)
  • Read-only access to groups and webhooks
  • Cannot modify any team resource

A team can have at most one Owner. To transfer ownership, the current Owner must promote another member to Owner — this demotes the previous Owner to Admin automatically.

Transferring hosts

Hosts can be moved between workspaces — from your personal account to a team, from a team back to your personal account, or between teams you own or administer. The hostname and all update history are preserved; only the owning workspace changes.

  1. Open the host settings sheet from the dashboard.
  2. Scroll to Transfer to workspace.
  3. Select the destination workspace from the dropdown. Only workspaces where you hold an Owner or Admin role are listed.
  4. Confirm the transfer.

The host immediately disappears from the source workspace and appears in the destination. The host's individual update token does not change, so any devices configured with that token continue to work without reconfiguration.

If the host belongs to a group, it is removed from the group upon transfer, since groups are workspace-scoped and do not cross workspace boundaries. Reassign it to a group in the destination workspace after the transfer if needed.

Only Owners and Admins of the source workspace can initiate a transfer. Members do not have access to the transfer option.

Team billing

Each team has its own subscription, entirely separate from any personal plans held by its members. The team plan determines the limits that apply within the team workspace — maximum hosts, groups, webhooks, and member seats.

Only the team Owner can view and manage team billing. Admins and Members do not have access to the Billing section within a team workspace.

To manage the team plan, switch to the team workspace and navigate to Settings → Billing. From there you can upgrade or downgrade the plan, update the payment method, and download invoices.

Billing for the team is independent of the individual accounts of its members. A member's personal plan does not affect what the team can do, and vice versa.

Leaving and deleting

Any member — including Admins — can leave a team at any time from the Team settings page. Leaving removes you from the workspace immediately; you lose access to all team hosts, groups, and webhooks. Your personal workspace is unaffected.

The team Owner cannot leave while the team has other members. Transfer ownership to another member first, then leave, or delete the team entirely.

Deleting a team is a permanent, irreversible action. Only the Owner can delete a team. To delete:

  1. Switch to the team workspace.
  2. Navigate to Settings → Danger zone.
  3. Click Delete team and confirm by typing the team name.
Deleting a team permanently deletes all hosts in the workspace. DNS records for those hosts are removed immediately. There is no recovery option. Export or transfer any important hosts before deleting the team.

All active team subscriptions are cancelled at the end of the current billing period when the team is deleted. No further charges are made after deletion.

Was this page helpful?