Teams & Organizations
Organizations are the top-level workspace for servers, sites, members, and billing. Invite your team, assign roles, and collaborate with a clear permission model.
Overview
Everything in Deploynix belongs to an organization: servers, sites, databases, certificates, cloud provider credentials, Git repositories, DNS providers, and the subscription that pays for it all. You sign up as the Owner of your first organization, and you can be a member of any number of organizations owned by other people. Who gets to see or change each of those resources is decided by the member's role in the organization — one of Owner, Admin, Manager, Developer, or Viewer.
Organizations
When you register, Deploynix creates your first organization automatically and makes you its Owner. From there:
- Create another organization — use the workspace switcher in the top navigation to spin up a new one. Each organization has its own plan, members, and resources.
- Switch organizations — pick a different organization from the workspace switcher. The whole dashboard scopes itself to whichever organization is active; your servers list, sites list, settings, and billing all reflect it.
- Join someone else's organization — by accepting an invitation they send to your email.
Roles
Deploynix uses five built-in roles, stacked from most to least privileged. Each role has a numeric level that controls who can manage whom — you can only assign or change a role below your own.
| Role | Level | Scope |
|---|---|---|
| Owner | 100 | Full access — including billing, ownership transfer, and organization deletion. One Owner per organization. |
| Admin | 80 | Everything the Owner can do except delete the organization or transfer ownership. Can manage every other role. |
| Manager | 60 | Manages servers, sites, databases, certificates, and teams. Can view credentials, Git, DNS, and members but can't invite new members or change organization settings. |
| Developer | 40 | Creates, updates, and deploys sites; manages site environment variables and rollbacks. Views servers, databases, and certificates but can't create or delete them. |
| Viewer | 20 | Read-only access to servers, sites, databases, and certificates. Cannot make any changes. |
Permissions at a Glance
| Action | Viewer | Developer | Manager | Admin | Owner |
|---|---|---|---|---|---|
| View servers, sites, databases, certificates | ✓ | ✓ | ✓ | ✓ | ✓ |
| Deploy sites / rollback / manage env | — | ✓ | ✓ | ✓ | ✓ |
| Create / delete / restart servers | — | — | ✓ | ✓ | ✓ |
| Manage databases and certificates | — | — | ✓ | ✓ | ✓ |
| Manage credentials (cloud, Git, DNS) | — | — | — | ✓ | ✓ |
| Invite members & change roles | — | — | — | ✓ | ✓ |
| Edit organization settings | — | — | — | ✓ | ✓ |
| Transfer ownership / delete organization | — | — | — | — | ✓ |
Role Management Rules
Owners can manage every role. Admins can manage every role except Owner. Lower roles can't manage roles at all. You can never promote yourself.
Inviting Members
- Open Settings → Members.
- Click Invite Member.
- Enter the person's email address and pick a role. You can only pick a role below your own level.
- Click Send Invitation.
The invitee receives an email containing your organization's name, the role you're offering, your name as the inviter, and an Accept Invitation button. Invitations expire after 7 days; resend or cancel pending invitations from the same Members page. If the invitee isn't a Deploynix user yet, they'll register first and then be added to the organization on first login.
Plan-Based Member Limits
Every plan sets a max_members limit that caps how many members (including pending invitations) your organization can have. You'll see your current usage and remaining slots on the billing page.
Managing Members
Change a Role
From Settings → Members, click the role dropdown on any row and pick a new role. You can only promote or demote members to a role below your own level, and you cannot change the Owner's role here — use ownership transfer for that.
Remove a Member
Click the Remove action on the row. Access is revoked immediately: the member is signed out of the organization's context on their next request and loses visibility of every resource. Their user account still exists — removal is organization-scoped.
Leave an Organization
Any member can leave an organization from their account settings. Owners can't leave without first transferring ownership (see below) or deleting the organization.
Transferring Ownership
Only the current Owner can transfer ownership to another existing member. Open Settings → Members, pick a member, and choose Transfer Ownership. On confirmation:
- The chosen member becomes the new Owner.
- The previous Owner is demoted to Admin so they keep working access but lose ownership-only powers.
- Billing stays with the organization — it doesn't follow the old Owner.
Switching Between Organizations
If you belong to more than one organization, the workspace switcher in the top navigation lists each one. Clicking an organization sets your active context — every subsequent page in the dashboard, every API call you make from the browser, and every link you follow scopes itself to the selected organization. Switch back and forth freely; Deploynix remembers where you were last.
Organization Settings
Admins and Owners can edit organization-level settings from Settings → Organization:
- Name — the display name users see. Changing the name doesn't affect any resources.
- Members — invite, change roles, remove, and see pending invitations.
- Billing — subscription, plan, payment method, invoices. See Billing & Plans.
- Transfer ownership — Owner only.
- Delete organization — Owner only; requires explicit confirmation.
Danger Zone
Deleting an organization is permanent. Every server, site, database, certificate, backup, and team membership scoped to it is removed. Cancel your subscription first if you don't want to be charged for the next cycle.
Best Practices
- Give everyone the least privilege that does the job. Default new teammates to Developer or Manager and promote only when needed.
- Keep a backup Owner. Even though only one member holds the Owner role, make sure an Admin on the team can be promoted quickly if the Owner is unreachable.
- Remove members immediately when people leave. Role changes are live — don't wait for the next billing cycle.
- Separate production and staging into different organizations if you want hard isolation between credentials and billing. Put them in the same organization if you prefer shared resources and a single dashboard view.