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
tony.stark@starkindustries.comAdmin
pepper.potts@starkindustries.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
tony.stark@starkindustries.comAdmin
pepper.potts@starkindustries.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 Space.

Your Spaces

NameStatus
Space OneRunning

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 collaborate 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 Space.

Your Spaces

NameStatus
Space OneRunningShared

Connecting to Shared Spaces

The rest of this section describes how to access Spaces shared with you. Using the PairSpaces CLI you can see all the Spaces you can access using pair spaces.


> pair spaces

Space ID			        Name				        Shared with you	
-------------------------	-------------------------	----------------
677029e3e72826e42fe49fcb	Space One			        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 space SHARED_SPACE_ID.


> pair space 677029e3e72826e42fe49fcb

   ,     #_
   ~\_  ####_        Amazon Linux 2023
  ~~  \_#####\
  ~~     \###|
  ~~       \#/ ___   https://aws.amazon.com/linux/amazon-linux-2023
   ~~       V~' '->
    ~~~         /
      ~~._.   _/
         _/ _/
       _/m/'
Last login: Wed Jan 01 09:41:01 2025 from YOUR_IP_ADDRESS
[ec2-user@ip-SPACE_IP_ADDRESS ~]$

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 space SHARED_SPACE_ID.

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

DevContainer

You access DevContainers the same way you access DevContainers from your own Spaces. Create a Docker context for your shared Space using:


> docker context create CONTEXT_NAME --docker "host=ssh://SPACE_ID"

Successfully created context "CONTEXT_NAME"

where SPACE_ID is the name of configuration entry in your SSH configuration file created by PairSpaces (run pair space SPACE_ID once to create the configuration entry).

To activate the Docker context use the following command:


> docker context use CONTEXT_NAME

Current context is now "CONTEXT_NAME"

Using VSCode (or any IDE that supports DevContainers), open a directory that includes a DevContainer configuration file, i.e., devcontainer.json.

Note Your devcontainer.json file must be configured to work with PairSpaces. The values for workspaceFolder and workspaceMount should be as follows:

{
  "workspaceFolder": "/usr/src/app",
  "workspaceMount": "source=/space,target=/usr/src/app,type=bind,consistency=delegated"
}

Web

A Space that was configured to be accessible from the Web is available from a browser to any team member the Space was shared with. Navigate to https://pairspaces.com/pairs/SHARED_SPACE_ID and you will be be redirected to a private IDE in your browser.

Previous

Connecting to Spaces

Next

Sharing Services