Guides
Share with others
Add people to a workspace or give them one machine, choose what they can do, and look after your machines in the console.
Let other people see your machines, or run things on them with you. There are two ways to let someone in:
- Add them to a workspace. They see every machine in it, but can't open terminals on other people's machines.
- Share one machine. They can see it, or run things on it. They don't need to be in its workspace.
Add someone to a workspace when they should see all its machines. Share one machine when they need only that one, or need to run things on it.
You do both on the phone or in the console (chaar's website). To open the console, tap Open console in the phone's settings, or choose Profile › Open console in the desktop app's settings.
What can people do?
Your account comes with a workspace named after your email, and you're its owner. A machine joins a workspace when you set chaar up on it.
Every member sees every machine in the workspace: its sessions, their tab names and their status marks. Only the machine's owner, and people with Can run on it, can open its terminals and agent chats.
In a workspace
| Role | What they can do |
|---|---|
| Member | See every machine in the workspace and its sessions. Add their own machines to it. |
| Admin | Everything a member can, plus add, remove and change members. |
| Owner | Everything an admin can. Whoever makes a workspace is its owner. |
On one machine
| Access | What they can do |
|---|---|
| Can view | See the machine and its sessions. They can't open a terminal or agent chat. |
| Can run | Open terminals and agent chats, and create, rename and delete sessions. |
The console calls Can run Can execute.
Can run is shell access.
Their terminals run as the user account chaar runs under on that machine, which is usually yours. They can read, change and delete anything that account can. Give it only to people you'd trust with that account.
Add someone to a workspace
Owners and admins can add anyone with a chaar account.
- On Home, pick the workspace and tap the people button next to the gear. Sharing opens.
- Tap Add member, type their email and pick a role.
- Tap Add member. They get an invite by email, and join when they accept it.
- Pick the workspace at the top of the sidebar.
- Choose Manage workspace › Users › Invite.
- Type their Email address, pick a Role and choose Add user. They get an invite by email, and join when they accept it.
Share one machine
Only a machine's owner can share it.
- On Home, long-press the machine's name and choose Who has access.
- Tap the share button, a person with a plus.
- Type their email, pick Can view or Can run, and tap Share. Their access starts when they accept the invite.
- Open Machines and choose the machine.
- Choose Share Machine.
- Type their Email address, pick a Role and choose Add user. Their access starts when they accept the invite.
Accept an invite
- Open the link in the email. It opens the console.
- Sign in with that email's account and choose Accept.
A new invite replaces the old one. The console lists invites that are still waiting, and Cancel takes one back. If a link doesn't work, see Troubleshooting.
Change or remove someone's access
- Tap the people button on Home. Sharing opens.
- On the Members tab, tap a person to change their role or remove them.
- On the Machines tab, tap a person to switch between Can run and Can view, or tap Remove access.
- Open Manage workspace › Users, or a machine's Users tab.
- Choose the ⋯ button next to the person, then Change role, or remove them. Removing doesn't ask first.
A change can take up to about 5 minutes to apply, and a connection that's already open isn't cut. Removing someone from a workspace doesn't take away a machine you shared with them directly.
Open machines shared with you
Machines from workspaces you're not in show under Shared with me. Pick it from the workspace name in the desktop sidebar, at the top of Home on the phone, or in the console's workspace picker. In a terminal, it's the Shared tab: see Use chaar in a terminal.
To open their sessions, ask the owner for Can run.
Make another workspace
On the phone, tap the workspace name at the top of Home and choose New workspace. In the console, choose Create workspace in the workspace picker. You're its owner.
To put a machine in it, pick it as the Workspace when you set the machine up, or add the machine later.
Add a machine to another workspace
The machine's owner does this in the console.
- Pick the workspace at the top of the console's sidebar, and open Machines.
- Choose Add machine and open the Existing machine tab.
- Choose Add beside the machine. It now shows in that workspace too.
Sessions started in one workspace don't show in the other.
Rename or remove a machine
The machine's owner does these in the console. Pick the workspace, open Machines, then the ⋯ button on the machine's row.
- To rename it, choose Rename.
- To remove it from the workspace, choose Remove from workspace. If that's its only workspace, this deletes the machine.
Removing a machine doesn't stop chaar on it. To do that, see Remove chaar from the machine.
Stuck? Ask in the Discord community.