> For the complete documentation index, see [llms.txt](https://help.cerby.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cerby.com/cerby-web-app/users/join-cerby-from-a-guest-user-invite.md).

# Join Cerby from a guest user invite

This article describes how an external collaborator can join a Cerby workspace from a guest user invite sent to their email.

{% hint style="info" %}
**Who can use this feature?**

* Workspace **Guest Users**
* Supported using the Cerby web app
  {% endhint %}

As a guest user, you receive an email to set up your Cerby account and join a workspace through the web app.

Follow this article only the first time you join a workspace, because you need the temporary password from your invite email. If you have already set your password, follow the steps in the article [Log in to Cerby as a guest user](/cerby-web-app/users/log-in-to-cerby-as-a-guest-user.md) instead.

{% hint style="danger" %}
**IMPORTANT:** Read steps 2 and 3 before you click the **Join as a guest** button. After you click it, you have only a few seconds to click the **Log in as guest user** button before you are redirected to the corporate identity provider’s login page. If you are redirected, close the browser tab and click the **Join as a guest** button again.
{% endhint %}

To join Cerby from a guest user invite, you must complete the following steps:

1. Open the message Cerby sent to your email address, as shown in **Figure 1**. The message contains the following account details you need to set up your account:

   * **Workspace name**
   * **Username**
   * **Temporary password**

   <figure><img src="https://2432765489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA5ttyhSeCwMoE7UPFgC6%2Fuploads%2Fgit-blob-7b82e9a5142a1bb96dd9a58fd74bdf92c1dceb98%2Fguest-user-invite-email.png?alt=media" alt="Screenshot of the guest user invite email. The Join as a guest button is highlighted."><figcaption><p>Figure 1. Guest user invite email</p></figcaption></figure>
2. Click the **Join as a guest** button from the message. An authentication waiting page is displayed in your web browser\
   **IMPORTANT:** Proceed to step 3 right away because, after a few seconds, you are redirected to the corporate identity provider’s login page. You cannot set up your account on that page; therefore, you must close the browser tab and follow step 2 again.
3. Click the **Log in as guest user** button, as shown in **Figure 2**. The Cerby authentication page is displayed.

   <figure><img src="https://2432765489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA5ttyhSeCwMoE7UPFgC6%2Fuploads%2Fgit-blob-6c2c3432bc7185d97f0d6e9802492b25644a53db%2FR_Z3icvJIgUoeHaXlB_CM07ZzwZhuW_-Bq6cov93iKETn8pH7Ap2sqFYfa_UpeEpQGsPxSfhJ4non7KdIOQZwVdYorL0s2poyrRd1qdQ7j7bDmPRxVxFBQzf2Y-Qr-E9YONTuuPetI65PU3IM__keYQ.png?alt=media" alt="Screenshot of the authentication waiting page. The Log in as guest user button is highlighted"><figcaption><p>Figure 2. Authentication waiting page</p></figcaption></figure>
4. Enter the username and temporary password emailed by Cerby in the corresponding fields, as shown in **Figure 3**.

   <figure><img src="https://2432765489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA5ttyhSeCwMoE7UPFgC6%2Fuploads%2Fgit-blob-5a6c0dd2db7b3a98da3a36314e4d3914f4f9a4d4%2FmLIoljueWXVToL_I_XQZwy6BzfI1X5zNYepdOTnRnTQzk4Efozm1mXv_cSvIIWcWd9jEHoLjLWTmbK2T0YktP68uYfk_t3MO3hyXevDUYb_iBrd3trpF-LiObiWl4_0S95Hr1egCX52tbrdJjrfnHgk_1.png?alt=media" alt="Screenshot of the Cerby authentication waiting page. The Username and Password fields are highlighted."><figcaption><p>Figure 3. Username and Password fields in the Cerby authentication page</p></figcaption></figure>
5. Click the **Sign in** button. The **Change Password** page is displayed, as shown in **Figure 4**.

   <figure><img src="https://2432765489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA5ttyhSeCwMoE7UPFgC6%2Fuploads%2Fgit-blob-4fd1762e9de49c8b8876eaaff1907a2e35fa679e%2F5X8WADtbD8YgfFXk8fFdgEZJanM5zdHqW7nMEZomsNoFf8EskpoEFsL5NqUv4ikj0G06IXzZrupoW4I6PMQPdotD8Goo5Q6M4L7IDwrOKdSxaKoCiVfyx3bBHuv-wC1UJZ2T9frTDVT17_CW9nF3sYA.png?alt=media" alt="Screenshot of the Change Password page. The New Password, Enter New Password Again, Name, and Family name fields are displayed with the Send button below them."><figcaption><p>Figure 4. Change Password page</p></figcaption></figure>
6. Enter a new password for your Cerby account and your profile information in the corresponding fields:
   * **New Password**
   * **Enter New Password Again**
   * **Name**
   * **Family name**
7. Click the **Send** button. The Cerby web app dashboard is displayed.

Now you are done. For an optimized and secure experience, Cerby recommends all guest users complete the steps from the article [How to create and configure a local user workspace](https://help.cerby.com/setup-and-admin/workspace-identity-federation/local-workspace/create-and-configure-a-local-workspace):

1. [Install the Cerby mobile app and browser extension](https://help.cerby.com/setup-and-admin/workspace-identity-federation/local-workspace/create-and-configure-a-local-workspace#h-37549fc7b7)
2. [Turn on MFA for your Cerby account](https://help.cerby.com/setup-and-admin/workspace-identity-federation/local-workspace/create-and-configure-a-local-workspace#h-295eef3f10)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.cerby.com/cerby-web-app/users/join-cerby-from-a-guest-user-invite.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
