Workspace administration
Invite and manage your team
Invite people, choose their roles, withdraw access, leave or delete a workspace, and delete your account.
Invite a teammate
#Owners can invite people from Members.
- Open Members and choose Invite member.
- Choose Member for everyday development, or Owner for someone who also manages keys and members.
- Choose how long the link lasts. The default is 7 days, and the longest is usually 30 days.
- Copy the one-time invitation link and send it privately to the person you are inviting. Closing the dialog forgets the link.
- They open the link, sign in, check the workspace name and choose Join.
Choose the right role
#| Role | What they can do |
|---|---|
| Member | See the workspace’s tunnels, requests and usage; create tunnels; and rotate, revoke or delete the tunnels they created and change their body capture. |
| Owner | Everything a member can do, plus rename any tunnel, manage every tunnel and key, invite people, change roles and remove members. |
Owners change a person’s role on Members. A workspace always keeps at least one owner, so make someone else an owner before you change or remove the last one.
Manage pending invitations
#Owners see unused invitations under Pending invites on Members, with when each expires. Revoke one to stop its link working at once. Used and expired links drop off the list.
Recover or withdraw access
#- An invitation expired or was already used: links work once and cannot be reused. Ask an owner for a new one.
- An owner invitation stopped working after a service upgrade: older unused owner links may be revoked during a security upgrade. Ask a workspace owner to issue a new link. If the workspace has no owner yet, contact Groundhog support for a replacement first-owner link.
- Someone leaves the team: an owner removes them on Members. That removes their dashboard access only, so rotate any tunnel keys they knew.
- You can’t find a tunnel: check the workspace switcher shows the right workspace.
Removing a member also stops their open live-request feeds from receiving new rows. Requests already displayed in their browser are not erased. Rotate any tunnel keys they knew to withdraw hosting access too.
Leave a workspace
#Open Settings and choose Leave workspace. You lose access at once, and you need a new invitation to join again. Tunnels you created stay in the workspace.
A workspace always keeps at least one owner. If you are its only owner, make someone else an owner on Members first, or delete the workspace.
Delete a workspace
#Owners can delete a workspace from Settings. Choose Delete workspace and enter the workspace address to confirm.
Delete your account
#Open the menu with your name, choose Account, then Delete account. The page lists each of your workspaces and what happens to it first.
- Workspaces with other people in them: you leave. Their tunnels stay, including ones you created.
- Workspaces only you are in: they are deleted, as in Delete a workspace.
- Workspaces where you are the only owner and others are members: make one of them an owner on Members, or delete the workspace, before you can delete your account.
Deleting your account signs you out in every browser and stops your CLI sign-ins working. Your name and email are removed from your workspaces and from invitations you created. Signing in again later starts a new account with no workspaces, and it can’t create another free workspace.
If your workspace is suspended
#A suspended workspace’s tunnels stop forwarding and its clients disconnect. The dashboard shows Workspace suspended instead of your tunnels and team. You can continue in another active workspace or choose Use another account to end your Groundhog session and choose an account at sign-in. Sign out ends your Groundhog session without starting sign-in. Contact Groundhog support to restore access. Once the workspace is restored, reopen it and restart any client that stopped for good.
Suspension also stops new rows in open live-request feeds. Data already delivered to a browser is not withdrawn.