chaarDocsDownloadConsole

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

RoleWhat they can do
MemberSee every machine in the workspace and its sessions. Add their own machines to it.
AdminEverything a member can, plus add, remove and change members.
OwnerEverything an admin can. Whoever makes a workspace is its owner.

On one machine

AccessWhat they can do
Can viewSee the machine and its sessions. They can't open a terminal or agent chat.
Can runOpen 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.

  1. On Home, pick the workspace and tap the people button next to the gear. Sharing opens.
  2. Tap Add member, type their email and pick a role.
  3. Tap Add member. They get an invite by email, and join when they accept it.

Share one machine

Only a machine's owner can share it.

  1. On Home, long-press the machine's name and choose Who has access.
  2. Tap the share button, a person with a plus.
  3. Type their email, pick Can view or Can run, and tap Share. Their access starts when they accept the invite.

Accept an invite

  1. Open the link in the email. It opens the console.
  2. 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

  1. Tap the people button on Home. Sharing opens.
  2. On the Members tab, tap a person to change their role or remove them.
  3. On the Machines tab, tap a person to switch between Can run and Can view, or tap Remove access.

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.

  1. Pick the workspace at the top of the console's sidebar, and open Machines.
  2. Choose Add machine and open the Existing machine tab.
  3. 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.

↑↓Move↩Open