---
url: /operate/workspace-and-invitations.md
---
# Your workspace: sign-in, password and invitations

A **workspace** is one advisor firm's account. It holds that firm's companies. One firm cannot see another firm's companies.

## A new workspace starts empty

A new workspace has no companies. Home shows a **Get started** list. The sample company (Cobalt Industrial Supply) is added only when you select **Open the sample**. It is your own fictional copy.

## Sign in

1. Open the sign-in page.
2. Select **Advisor? Sign in with a password**.
3. Enter your email and your password.

A client's team members have no password. They sign in with an email code. See [the client app guide](../client-app/).

## Reset your password

1. On the sign-in page, select **Advisor? Sign in with a password**, then **Forgot your password?**
2. Enter your email and select **Email me a link**.
3. Open the link in the email. It works one time and for 30 minutes.
4. Enter a new password two times and select **Save new password**. The password must have 10 characters or more.

When you save a new password, DutyGraph signs you out in every browser. Your MCP tokens do not change. To stop a token, revoke it in **Settings › MCP access**.

You can ask for 3 links in one hour. A new link stops the earlier links.

## Invite an advisor or a beta tester

Only an **operator** can do this. An operator is a person who runs this DutyGraph deployment. Other advisors do not see this panel.

1. Open **Settings › Workspace › Advisor workspaces**.
2. In **Invite someone**, enter the person's email in **Their email**.
3. In **Invite as**, select **Beta tester** or **Advisor firm**. This changes only the words in the email. A beta tester is asked to try DutyGraph and to say where they get stuck.
4. Optional: add a first name, a workspace name and a short note. The note goes into the email in your words.
5. Select **Send invitation email**.

DutyGraph sends the email with the person's link. Replies go to you.

| Fact | Detail |
| --- | --- |
| The link | Works one time, only with that email, for 14 days |
| A second invitation to the same email | Stops the first one |
| What the person gets | Their own empty workspace. They cannot see your workspace or any other workspace. |
| **Make link only** | Makes the same invitation and sends no email. You send the link yourself. The link is shown one time. |
| If the email cannot be sent | The invitation stays open. The panel shows the link and the reason. |

The invited person opens the link, enters a name, a password and the firm's postal address, and lands on an empty Home.

Not built: a record of who opened the email, and more than one advisor sign-in in one workspace.

## Open sign-up or invitation only

The server setting `SIGNUP_MODE` controls who can make a workspace.

| Value | Result |
| --- | --- |
| `open` (default) | Anyone can select **Create an advisor workspace** on the sign-in page |
| `invite` | Only a person with an invitation link can make a workspace. The sign-in page does not show **Create an advisor workspace**. |

The **Advisor workspaces** panel tells you which mode is on.

## See the workspaces and turn one off

The **Advisor workspaces** panel lists each workspace, its advisors and its number of companies.

**Turn off** stops a workspace:

* Sign-in is refused with the message "This workspace is turned off".
* Each browser session of the workspace ends.
* Its MCP tokens are refused.
* No password reset email is sent.

Nothing is deleted. **Turn on** gives access back. You cannot turn off your own workspace.

::: warning Not stopped by Turn off
Links that a client's people already have (sponsor links and question links) and Companion mobile sessions continue to work.
:::

## What the server needs

| Need | Detail |
| --- | --- |
| SQL `0129-account-access` | Before it runs, password reset, invitations and the workspace list answer `MIGRATION_REQUIRED` |
| The platform mailbox | `MAILBOX_RESEND_API_KEY` and `MAILBOX_EMAIL_FROM`. Without them, **Send invitation email** answers `EMAIL_NOT_CONFIGURED`. |
| Operator emails | `DUTYGRAPH_OPERATOR_EMAILS`, a list of sign-in emails with commas between them |
