Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gnmyt/Nexterm/llms.txt

Use this file to discover all available pages before exploring further.

Organizations in Nexterm let you share server entries and identities across a team without giving everyone full admin access to the instance. When you create an organization, you become its owner and can invite other Nexterm users as members. Any server entry placed inside an organization folder is visible to every active member of that organization.

What organizations control

Shared server entries

Entries scoped to an organization appear in the sidebar for every active member, not just the creator.

Shared identities

Identities can be organization-scoped so that all members can authenticate to shared servers using the same credentials.

Audit settings

Each organization has its own audit configuration covering connection logging, file operations, session recording, and more.

Role-based access

Members have either the owner or member role. Only owners can invite users, remove members, and update organization settings.

Creating an organization

1

Open the organization settings

Navigate to Settings → Organizations and click New organization.
2

Enter a name and description

Give the organization a clear name and an optional description so teammates can identify it.
3

Save

Click Create. You are automatically added as the organization owner with active status. An organization folder for this organization appears in the sidebar.

Inviting members

Only organization owners can invite users. Invitations are sent by username — the invitee must already have a Nexterm account.
1

Open the member list

Go to Settings → Organizations, select your organization, and open the Members tab.
2

Enter a username

Type the Nexterm username of the person you want to invite and click Invite.
3

Invitee accepts

The invitee sees a pending invitation in their notification area or under Settings → Invitations. They can accept or decline.
  • Accept: their status changes to active and the organization folder appears in their sidebar.
  • Decline: the invitation record is removed.
A user cannot be invited twice. If an invitation is already pending, or the user is already an active member, the invite request returns a conflict error.

Member roles

RolePermissions
ownerInvite and remove members, update organization settings, manage audit configuration, delete the organization
memberAccess organization server entries and identities; cannot manage members or settings
If the designated owner leaves or is removed, a system admin can act as owner for that organization until a new owner is assigned.

Organization-scoped server entries

Server entries are scoped to an organization when they are placed inside an organization folder, or when their organizationId field is set directly. Organization-scoped entries behave like personal entries from the user’s perspective — you connect to them the same way — but they are visible to every active member of the organization.
1

Open the organization folder in the sidebar

Expand the folder with the organization’s name. It appears automatically once you are an active member.
2

Add an entry

Right-click the organization folder and choose New server. Fill in the connection details as usual. The entry is saved with the organization’s ID and becomes visible to all members immediately.
3

Move an existing entry

Drag an existing personal entry into the organization folder. Nexterm reassigns the entry to the organization. Any identities that belonged to your personal account (not the organization) are automatically removed from the entry when you move it.
Moving an entry into an organization folder removes any personal identities attached to it. Make sure the relevant identities exist as organization-scoped identities before moving.

Switching between organizations

You do not need to “switch” organizations explicitly. All organization folders you belong to appear simultaneously in the sidebar alongside your personal entries. If you are a member of multiple organizations, each has its own folder in the tree.

Leaving and deleting organizations

Go to Settings → Organizations, select the organization, and click Leave organization. Your membership record is removed and the organization folder disappears from your sidebar.
Organization owners cannot leave their own organization. You must delete the organization instead, or transfer ownership before leaving.

Audit settings

Each organization stores an auditSettings object that controls which events are logged for that organization. Owners can update these settings from Settings → Organizations → Audit.
SettingDefaultDescription
requireConnectionReasonfalsePrompt members to enter a reason before connecting to a server
enableFileOperationAudittrueLog SFTP file operations (upload, download, rename, delete)
enableServerConnectionAudittrueLog SSH, RDP, VNC, and Proxmox connections
enableIdentityManagementAudittrueLog identity create, update, and delete events
enableServerManagementAudittrueLog entry create, update, and delete events
enableFolderManagementAudittrueLog folder create, update, and delete events
enableScriptExecutionAudittrueLog script executions run against organization servers
enableSessionRecordingfalseRecord terminal session content
recordingRetentionDays90Number of days to keep session recordings

Build docs developers (and LLMs) love