Appearance
Workspace and members
This page is for admins: set up the workspace, bring people in, and decide who can do what.
INFO
Some limits depend on your plan. On a Free workspace, up to 5 people (apps excluded) can be members; guests, people from other companies and the client portal need the Team plan; single sign-on needs Business. Only the owner changes the plan. Self-hosted installs without plans have no limits.
First week as an admin
Everything below is under Settings in the web app. Admin pages sit in the Workspace and Admin groups of the Settings list.
- Day 1: set the name and address. Settings, General. See Name and address.
- Day 1: choose default channels, so new people land somewhere. See Default channels and the first day.
- Day 1: invite your first people. Settings, Members. See Invite people.
- Day 2: set roles. Make a second admin so you aren't the only one. See Roles.
- Day 2: create teams such as
@design, and decide who may create them. See Teams. - Day 3: set the sign-in policy. Settings, Security: require two-factor, or connect your company sign-in. See Single sign-on.
- Day 4: decide who may add apps. Settings, Integrations, Who can add apps. See Apps and integrations.
- Day 5: set how long history is kept and check AI. See Data and compliance and AI settings.
Name and address
Ana owns "Acme Studio" and wants a clean link.
- Open Settings, General.
- Under Workspace name, type the name and press Save. It can't be empty and takes up to 60 characters. Everyone sees the change.
- Under Workspace address, press Change address, type
acmeand confirm. - Connectdary now opens at
https://connect.example.com/acme, or atacme.example.comwhere the server gives each workspace its own subdomain. People sign in once for all of them.
Old links to the workspace, including old invite links, stop working when you change the address. Use letters, numbers and dashes. An address another workspace has, or a reserved one like admin, is refused.
The same page has the workspace colour, which people see until they pick their own and which the client portal uses.
Roles
- Owner: everything an admin can do, plus making admins and changing the plan. Nobody can deactivate the owner.
- Admin: manages settings, members, apps and data.
- Member: the everyday role. Joins public channels and can invite people.
- Guest: sees only the channels they're added to. Guests can't invite.
- External person: someone from another company or a client. See People from another company and clients.
To make Ben an admin:
- Open Settings, Members, People.
- Find Ben with the filter (it searches names and email addresses) and open his row.
- Change Role to Admin. It applies at once.
Only the owner makes admins. Members can't change roles.
When someone leaves
- Open Settings, Members, People, and open the person.
- Choose Deactivate and confirm. You can hand their files and open replies to someone else.
Deactivating ends their sessions on every device, stops their agent tokens and phone notifications, and keeps their past messages. Their other workspaces are unaffected. On Free it frees their place. Reactivate brings them back with the same account, and counts against the limit again.
Invite people
Marco wants Ben in.
- Open Settings, Members, then Invite people.
- Enter
ben@example.comand choose Join as: Member or Guest. - Press Send invite. Or press Create invite link to share the link yourself.
The link works once, for that address, for 7 days. Settings, Members, Invites lists pending invites. Resend the email renews the link; Revoke invite stops it.
To let people join without an invite, open Settings, Members, Joining:
- Turn on Let people sign up on their own.
- Under Email domains, add
example.com. - Pick the role they get under Join as.
They prove their address with a code sent by email. See Joining and signing in for what they see. You can also import history from Slack.
Default channels and the first day
- Open Settings, Channels and open a public channel's menu.
- Switch on New members join. The channel is now a default channel and can't be archived until you switch it off.
- Check the result under Settings, General, Default channels.
Default channels apply once per person, so someone who left a channel isn't added back.
To start roles and teams in different channels, use Settings, Home for new members, First day. Press Add a role or team, pick Guest, Member or a team, and choose public channels. New people who match join them on their first day. Show the start page turns the new-member start page on or off.
Teams
Teams let people mention a group by handle, such as @design.
- Settings, Channels, Who can create teams: Everyone or Admins only.
- A member, or an admin, opens Browse, Teams and creates the team with a name and a handle. It is Open (anyone can join) or Managed (only team managers change who is in it).
Handles use lowercase letters, numbers and dashes. A taken handle is refused, and channel, here and everyone can't be used. A team always needs a team manager, so the last one can't leave. When Ben writes @design in #launch, he's told if someone in @design isn't in the channel.
People from another company and clients
Marco works with the agency Globex on a launch. Kenji at Globex needs #launch and nothing else.
- Optional: open Settings, External people and switch on Members can invite people from another company. Otherwise only admins can.
- Open
#launch, then its Members, and choose Invite someone from another company. - Enter
kenji@globex.exampleand the company,Globex, and send. - Kenji opens the link, gives his name and chooses Email me a code. No password.
Kenji joins #launch with "Globex" next to his name. He sees no other channels and only the people on the project. This needs the Team plan.
Everyone invited from another company, agency or client, uses the client portal instead of the full app. Lena, a client, opens https://connect.example.com/p/acme and signs in with an emailed code. She sees the shared channels, DMs with your team, files shared with her and the people on her projects.
To brand the portal, open Settings, Client portal:
- Set the Name, for example "Acme Clients".
- Upload a Logo: a square PNG or JPEG up to 1 MB, then crop it.
- Pick an Accent colour. It shows at the top of the portal and in sign-in emails.
Settings, External people lists everyone by company with the channels they share. Remove them from one channel or from the whole workspace. A removed person loses access at once and can't be invited back. Settings, Client portal shows each client's last visit, and Export #launch emails you a ZIP of a shared channel's messages and files for handover.
Single sign-on with Okta or Microsoft Entra
Needs the Business plan. Owners and admins set it up under Settings, Security. People sign in with their company account. Accounts are server-wide, so it applies wherever they sign in on this server.
1. Prove you own the domain
- Under Company domains, type
example.comand press Add. - Connectdary shows a TXT record named
_connect-verify.example.comand its value. Copy the value. - Add the record at your DNS host, then press Check again until the domain shows Verified.
Public mail domains can't be claimed. A domain another workspace holds is refused.
2. Connect the provider
Choose OpenID Connect for Okta, Microsoft, Google, Authentik or Keycloak, and Other providers (SAML) for the rest. Press Set up.
OpenID Connect. In your provider, create a web application and paste Connectdary's Redirect URL into it. Connectdary shows it in the form:
https://connect.example.com/api/auth/sso/acme/callbackThen copy these from your provider into Connectdary:
| Connectdary asks for | What to paste |
|---|---|
| Issuer URL | Your provider's issuer, the address that serves /.well-known/openid-configuration |
| Client ID | The application's client ID |
| Client secret | The application's secret |
| Company domains | example.com |
Connectdary asks the provider for the scopes openid email profile.
SAML. In your provider, create a SAML app and enter these two addresses:
| Your provider asks for | Enter |
|---|---|
| Single sign-on URL, or ACS URL (HTTP-POST) | https://connect.example.com/api/auth/sso/saml/acme/callback |
| Audience, or Entity ID of the service | https://connect.example.com/api/auth/saml/acme |
Connectdary's form shows the ACS URL but not the Entity ID, so copy it from here. Use your own workspace address instead of acme. The provider must sign the assertion, use a NameID of format persistent or email address, and send the email in an attribute.
Back in Connectdary, paste the provider's Metadata URL (or the metadata XML), set Email attribute (it starts as email) and Company domains, and press Save.
3. Test, then require it
- Press Test sign-in. A window opens at your provider. When it works, Connectdary says "It works. Your provider signed you in." and the row shows Tested.
- Under Recovery owner, choose an owner who has a passkey. They can always sign in with it.
- Switch on Require single sign-on and confirm. Passwords stop working for those domains.
You can't require it before a test sign-in, a recovery owner with a passkey and verified domains. Once it is required, only the owner can switch it off. The same page has Require two-factor for everyone. On the phone there is no test sign-in; use the web.
4. Optional: SCIM provisioning
SCIM lets your provider add, update and deactivate people for you.
- Under SCIM, press Create a token.
- Copy the SCIM URL and the Token. The token starts with
scim_and is shown once. The URL looks like this:
https://connect.example.com/api/scim/v2/acme- In your provider's provisioning settings, give the URL as the base URL and the token as a Bearer token. Turn on creating, updating and deactivating users.
How it behaves:
- When the provider adds
ben@example.com, Ben appears in Members. If the domain isn't verified yet, Ben gets a pending invite instead. - When it deactivates or deletes Ben, he can't sign in, and his past messages stay.
- Only users are synced. Groups aren't.
- Replace the token ends the old one at once. Turn off stops syncing.
- A full Free plan refuses new people.