Workspaces
A workspace is the top-level organizational unit in Miget. Every user has at least one workspace, and all resources (apps, services, projects, databases) belong to a workspace.Workspace Types
Miget offers different workspace plans to match your team’s needs:
Creating a Workspace
When you sign up, a default workspace is created for you. You can create additional workspaces from your dashboard to organize different projects or teams.
You must always have at least one workspace. The last workspace cannot be deleted, and neither can a workspace that still holds apps, resources or services — delete those first.
Members
Members are users who have access to a workspace. Anyone holding theworkspace:members permission — the Admin role by default, and always the workspace owner — can invite new members and manage their access.
Member Statuses
Inviting Members
- Navigate to Settings → Members in your workspace
- Click Invite Member
- Enter the email address and select a role
- The invitee receives an email with instructions to join


On Team and above, inviting past your plan’s included seats adds billed seats at $5 per member per month.On Personal, the member limit is a hard stop: the Invite Member button is disabled once you reach it, and seats cannot be bought. Upgrade the workspace to invite more people. Personal workspaces can only invite collaborators.
Managing Members
Anyone with theworkspace:members permission can:
- Change roles - Update a member’s role to adjust their permissions
- Suspend members - Temporarily revoke access without removing them
- Reactivate members - Restore access to suspended members
- Remove members - Permanently revoke access
Transferring Ownership
Only the current owner can hand a workspace over, from Settings → Members using the crown action next to an active member. The new owner must already be an active member, and must not own another workspace with the same name. When the transfer completes, both of you are notified by email and the previous owner stays in the workspace as a member with the Admin role.A workspace with an active paid subscription cannot be transferred here, because the subscription cannot be moved between customers on its own. Contact support — the billing side is moved first, then the ownership.
Roles
Roles define what actions members can perform within a workspace. Miget provides built-in roles and supports custom roles for Organization and Enterprise plans.Built-in Roles
Permissions
Permissions are organized by domain:Workspace Permissions
Workspace Permissions
workspace:general- General workspace settings, API tokens, webhooks, the activity feed and activity exportsworkspace:security- Workspace security settingsworkspace:credentials- Git and container registry credentialsworkspace:integrations- Workspace integrationsworkspace:billing- Plan, billing, invoices and ordersworkspace:members- Invite, suspend, reactivate and remove members, and change their rolesworkspace:roles- Create, edit and delete custom roles
App Permissions
App Permissions
apps:manage- Create and delete apps, their domains and TLS certificates, and give a port or a database a public addressapps:deploy- Deploy new versions, start, stop and restart apps, and create git tokensapps:operate- Add-ons, cron jobs, private ports and app settingsapps:view- View app details and logs
Project Permissions
Project Permissions
projects:manage- Create and delete projects, and assign resources to them (assigning also needsresources:manage)projects:operate- Modify project settingsprojects:view- View project details
Service Permissions
Service Permissions
services:manage- Create and delete servicesservices:operate- Modify service settingsservices:view- View service details
Resource Permissions
Resource Permissions
resources:manage- Create and delete resourcesresources:operate- Modify resource settingsresources:view- View resource details
Bucket Permissions
Bucket Permissions
buckets:manage- Create and delete bucketsbuckets:operate- Upload, rename and delete objects, manage policies and ACLs, and change a bucket’s settingsbuckets:view- View buckets, list their objects and download them
Network Permissions
Network Permissions
network:manage- Create and delete private networks, switch VPN gateways on and off, and add or remove site-to-site tunnels — everything that costs money or spends a public addressnetwork:operate- Rename a network, carve subnets, attach workloads, add WireGuard devices and download their configuration, and manage the networks reachable through a gatewaynetwork:view- View private networks, their subnets and their attachments
Deleting a workspace and transferring its ownership are not permissions — they are reserved for the workspace owner and cannot be granted to a role.
Custom Roles
Custom roles are available on Organization and Enterprise plans.
- Navigate to Settings → Roles
- Click Add Role
- Enter a name and select the permissions
- Click Create Role

Role Comparison
Why a role does not see something
A missing button is a permission, not a fault. A page does not show a control the role cannot use, so somebody without the permission for an action sees a page without it rather than an error after clicking. If a member reports that something “disappeared”, the answer is almost always in this section. The one deliberate exception is the paid VPN surface. A gateway and a site-to-site tunnel stay visible and greyed for anyone who can operate a network, with a line saying who to ask, because that block is lifted by buying rather than by a role change.Where the line falls
Operate runs what already exists. Manage owns three things beyond that:- The life of a top-level record. Creating and deleting an application, a service, a bucket, a project, a resource or a private network.
- Anything that costs money. A VPN gateway and a site-to-site tunnel, which are billed monthly and hold a public address of their own.
- Anything that ends stored data. Deleting a database or resetting it.
Common questions
A few of these are asymmetric on purpose. A Collaborator can add a database
but not delete it, because creating one takes capacity from a resource you
already pay for while deleting one ends data nothing brings back. For the same
reason they can restore a backup — that is recovery — but not reset the
database.
Public access is not a
manage action. Exposing a port or giving a database
a public address allocates an endpoint on a shared proxy — it costs nothing, and
the role that turns it on turns it off — so it stays with operate, in both
directions, and so do replicas. What needs manage is a domain or a TLS
certificate, which are the application’s public identity.The same answer through the API
Every permission above applies identically to the API. A call a role cannot make in the panel answers403, and a workspace API token is limited by its own
permission list rather than by its creator’s role — a token created for
read-only use cannot deploy, stop or scale an application, whoever made it.
Project Access
By default every project is open to the whole workspace: anyone who can see projects can see all of them. Organization and Enterprise workspaces can change that under Settings → General → Default project access; with it off, a new project is visible only to whoever created it until they share it. Project access closes a single project to a named list of people and roles, so a workspace can hold work that not everyone is meant to see.Restricting a project is available on Organization and Enterprise plans.
Closing a project
- Open the project and go to Settings → Access
- Click Grant access and pick members from the workspace list, or a role — everyone holding that role reaches the project
- The first entry you add is what closes the project
Who still gets in
An entry never locks out the people who have to be able to administer the workspace:- The workspace owner always reaches every project.
- Holders of the built-in Admin role always reach every project.
What a restricted project looks like to everyone else
A project someone cannot reach is not shown to them as forbidden — it is not shown at all.- It is absent from their project list, and so are its applications, static sites, services, stacks and buckets in the lists those appear in.
- Opening one of them by URL gives a not found page rather than a permission error.
- Its resources drop out of resource lists and pickers if no other project they can reach is using them.
Access controls visibility and reach, not roles. Someone who reaches a restricted project still acts inside it with whatever their role allows — a Collaborator added to a project’s access list can deploy there, not manage it.

