Skip to Content

PairSpaces

DocsBlog

PairSpaces

Sharing Spaces

How your team joins your Space

Sharing your Spaces with your team is the first step to working together with them. This section describes how to create a team and how your team uses the PairSpaces CLI to join your Spaces.

Create a Team

You can share your Spaces with your team members using the PairSpaces web application. Navigate to Team.

No Team.

Add team members to collaborate in your Spaces.

If you haven't invited a team member to work with click Add Members. Enter their email address and a role you want them to have.

Add to Your Team

Include an email address and select a role for the new team member.

The roles you can choose are:

  • Admin. The administrator role provides access to all account features including Spaces, Team, and Settings. The administrator role is the only role that can delete the account.
  • Billing. The billing role provides access to Billing in Settings and can access invoices only.
  • Member. The member role provides access to Spaces, Team, and Settings (excluding billing and account deletion).

When you add a team member they receive an email. The email contains a link that completes their account setup. Initially, you will see their account status as Invited.

You have one collaborator. You have one pending invitation.

Your Team

EmailRole
alice@pairspaces.comAdmin
bob@pairspaces.comInvited - Member

When they set up their account, they are able to access their PairSpaces account as a member of your team. Their status changes from Invited to Member.

You have two collaborators.

Your Team

EmailRole
alice@pairspaces.comAdmin
bob@pairspaces.comMember

Share Your Space

You can share your Spaces with your team using the PairSpaces web application. Navigate to Spaces. If you have not created a Space create one using Creating Spaces.

You have one Cloud Space.

Cloud Spaces

NameStatus
dynamic-stark
Running

Click the Share icon () the Space you want to share with your team. And then select the team member you want to work with from your Space and click Share.

Share Your Space

Sharing allows your team to log into your Space and work together in real time from anywhere.

Your team

Choose a team member to work with.

Your team will see Spaces shared with them from their account.

You have one Cloud Space.

Cloud Spaces

NameStatus
dynamic-stark
RunningShared

Connecting to Shared Spaces

The rest of this section describes how to access Spaces shared with you. Using the PairSpaces web application, you can click on the copy icon () to copy the full command to connect to a Space (pair spaces connect SPACE_ID).

Using the PairSpaces CLI you can see all the Spaces you can access using pair spaces list.


> pair spaces list

Space ID			        Name				        Shared with you	
-------------------------	-------------------------	----------------
68704fdcf60bbb90e2b801f3	dynamic-stark			    Yes		
-------------------------	-------------------------	----------------

Spaces shared with you are indicated by a Yes under Shared with you.

Terminal

You access shared Spaces the same way you access your own Spaces using pair spaces connect SHARED_SPACE_ID.


> pair spaces connect 68704fdcf60bbb90e2b801f3
[root@123abd456] > ls -l
total 12
-rw------- 1 root root 2508 Nov 19  2023 anaconda-ks.cfg
-rw-r--r-- 1 root root  133 Nov 19  2023 anaconda-post.log
-rw------- 1 root root 2068 Nov 19  2023 original-ks.cfg

IDE

You access shared Spaces from your IDE the same way you access your own Spaces. For example, VSCode's Remote SSH extension works with any Space defined in your SSH configuration file.

Note Your SSH configuration file is updated to include your Space when you run pair spaces connect SHARED_SPACE_ID.

When prompted select the SSH configuration entry labeled with the SHARED_SPACE_ID.

Select the directory /space from your Space to see the directory that was shared with you.

Previous

Connecting to Spaces

Next

Sharing Services