# Getting Started

## Signing In

Go to your institution's chestnut.tools URL and click **Sign in**.

Two sign-in methods are available:

### Google

Click **Sign in with Google** and complete the standard Google OAuth flow. You must use the email address your institution registered for you.

### Magic Link

1. Click **Sign in with magic link**.
2. Enter your institution email address and click **Send link**.
3. Check your inbox for an email from chestnut.tools and click the link inside.
4. You are signed in automatically — no password required.

> Magic links expire after a short window. If the link has expired, return to the sign-in page and request a new one.

## After Signing In

Where the app sends you depends on your role:

| Role                  | Destination                                 |
| --------------------- | ------------------------------------------- |
| Student               | `/dashboard` — your personal class schedule |
| Staff / Administrator | `/admin` — the admin panel                  |

If you land on `/join` instead of your destination, your account exists but has not yet been linked to an institution. Contact your administrator.

## Signing Out

* **Students**: open the floating action bar (bottom of the page) and click **Log out**.
* **Staff**: click the user menu in the top-right corner of the admin panel and select **Log out**.

## Common Sign-In Errors

| Error                                                                | Cause                                             | Fix                                                                             |
| -------------------------------------------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------- |
| `Tenant not found. Please contact your institution's administrator.` | The email domain is not registered in the system. | Double-check the email address. Contact your administrator if it looks correct. |
| `Signups not allowed for otp`                                        | The email is valid but no profile exists yet.     | Ask your administrator to create your account, then try again.                  |


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chestnut.tools/user-docs/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.