Sharing and workgroups

This page shows how to let someone else watch, run or manage one of your labs without giving them your account. Share with a person, or with a workgroup — a saved list of people you share with often.

Who can share

Sharing requires a paid plan or 7,500 Zeal. Below that, the share dialog shows a lock notice with how much Zeal you have; grants you already made stay visible and can still be revoked. See Zeal and Jolt.

Share a lab

1. Open the lab, or find it under Instances → My Instances, and select Share.
2. Under Who, type a person's email or name — suggestions appear as you type — or pick a workgroup, organization or department from the list.
3. Under As, choose a role.
4. Optionally, select Extras and Can re-share.
5. Select Share.

Shown on labs.selfmade.ninja, the Selfmade Ninja Academy platform. On your own platform you will see your own domain and data.

Roles

Role	What they can do
Viewer	Watch the lab and open its app (Launch). Cannot stop, redeploy or change anything, and does not see its credentials.
Operator	Also start, stop, pause and redeploy it
Manager	Also change its preferences and share it with others

Extras

Extras add one specific ability on top of the role, without raising the whole role. Only the extras that make sense for that lab are offered.

Extra	Adds
VS Code / terminal	A real shell inside the lab — only the owner can grant this
Open the app (Launch)	The lab's web interface
Stop / Redeploy	That one action
Terminate	Permission to destroy the copy — only the owner can grant this

Can re-share lets them pass their access on, at or below their own role. Only the owner, an admin or a manager can allow it.

What sharing never gives

Shared users do not get SSH — that needs their own device and keys on your account, which a share cannot give. Only the owner can transfer a lab, and only the owner can terminate it unless they granted Terminate.

When you share with a workgroup, organization or department, you can also choose whether it applies to All members or Owners & admins only.

Change or remove access

The Who has access list at the bottom of the same dialog shows every grant. Revoke a grant there. To give someone a different role, revoke and share again.

Finding shared labs

Instances → My Instances has tabs for everything you own and everything you can use:

Tab	What is there
All / Instances	Your own labs and copies
Shared with me	Labs and templates others shared with you, directly or through a workgroup. What you can do on each row depends on your role.
Shared by me	Every grant you made, grouped by lab or template
Scale groups	Your scale groups
Trash	Terminated copies you can still restore

Trash

When you terminate a copy and choose Move to trash, it lands in the Trash tab. Each entry shows how many days are left before it is purged automatically — 30 days after it was trashed.

Button	What it does
Restore	Brings the copy back with its configuration, and its data if it had isolated storage
Delete	Removes it permanently, straight away

Restoring needs a free copy slot. If you are at your copy limit, terminate another copy first.

Workgroups

A workgroup is a reusable audience: create it once, then share any lab or template with everyone in it in one step. Anyone can create one, and a person can belong to many.

Create a workgroup

1. Go to Instances → Workgroups and select New workgroup.
2. Give it a name and, optionally, a description.
3. Open the workgroup's Settings → Members and add people by username, as member or admin.

Shown on labs.selfmade.ninja, the Selfmade Ninja Academy platform. On your own platform you will see your own domain and data.

Share with it

Pick the workgroup in the Who box of any share dialog. Its Share defaults decide the role people get when you do not pick one:

Shared item	Default role
A template	Deployer — they can deploy their own copies
A running lab	Viewer

Adding someone to the workgroup later gives them everything already shared with it; removing them takes it away.

Roles in a workgroup

Role	Can
Owner	Everything, including deleting the workgroup. The owner cannot be removed.
Admin	Manage members
Member	Receive whatever is shared with the group

The same page lists Organizations & departments you belong to. Those are larger groups with their own plan — see Organizations.

Next

• Roles and permissions — every role in one place
• Scale groups — several replicas behind one URL
• Stop, pause and delete — what terminate and trash keep
• Organizations — shared labs, storage and limits for a team