> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Access and first steps

> What you need to sign in to Flexxible KB, how to access it from Flexxible Portal and what to do on the first day.

Flexxible KB opens from Flexxible Portal, with your usual account and without a second sign-in. This page explains the requirements, how to get in, how the interface is organized and where to start.

## Requirements

* **The knowledge base is turned on for your organization.** Flexxible turns it on. If your organization doesn't have it yet, request it from your Flexxible contact.
* **You have the right role in Portal.** Users with the *Organization administrator* or *L3 engineering team* role on their own organization can sign in. Read-only roles don't have access. See [Roles](https://docs.flexxible.com/en/features/administration/roles.md).

> [!NOTE]
>
> Delegated tenants aren't turned on separately: they follow the organization they depend on.

## Access

1. Sign in to [Flexxible Portal](https://portal.flexxible.com).
2. In the side menu, select **Knowledge base**.

Flexxible KB opens at `https://kb.flexxible.com` with your Portal session. You always enter your own organization's knowledge base.

Direct links to a page also work. If you don't have an open session in Flexxible KB, the link goes through Portal and then takes you to the page you wanted to open.

> [!NOTE]
>
> Every few minutes, Flexxible KB checks with Portal that you still have access. If your organization's knowledge base is turned off or your role changes, open sessions are closed within minutes.

### If you can't sign in

| Message | What it means |
| - | - |
| "The knowledge base is for your organization's administrators in Portal." | Your role in Portal doesn't give access. Ask an administrator in your organization to review your role. |
| "Your organization doesn't have the knowledge base turned on." | The knowledge base isn't turned on. Ask an administrator or Flexxible to turn it on. |
| "Your organization is no longer active in Portal." | The organization is deactivated in Portal. |
| "Couldn't sign in through Portal." | The sign-in didn't complete. Select **Try again**. |

## The interface

![Flexxible KB home: sidebar with the page tree, box to ask Teammate, recently read pages and the latest changes.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-home.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=f3f76ee4fca14e927da0681303de6758)

### Sidebar

The sidebar is always on the left. You can hide or show it with `Ctrl` + `B` (`⌘` + `B` on Mac).

| Element | What it contains |
| - | - |
| Organization menu | **Settings**, **Language**, **Keyboard shortcuts** and **Sign out**. |
| **Search** | Opens the [command palette](https://docs.flexxible.com/en/features/flexxible-kb/search.md). |
| **New page** | Creates a blank page and opens it for writing. |
| **New chat** | Starts a new question for [Teammate](https://docs.flexxible.com/en/features/flexxible-kb/teammate.md). |
| **Home** | Teammate, the last pages you've read and what's new. |
| **Changes** | All changes in the organization, with **Undo**. |
| **Diagrams** | All [diagrams](https://docs.flexxible.com/en/features/flexxible-kb/diagrams.md) and the pages each one is in. |
| **Vault** | The [credentials](https://docs.flexxible.com/en/features/flexxible-kb/vault.md) used by pages. |
| **Missing from the KB** | What agents needed and [didn't find](https://docs.flexxible.com/en/features/flexxible-kb/gaps.md). |
| **Teammate** | Your latest conversations with Teammate. Only you can see them. |
| **Pages** | The organization's page tree. |

Depending on the features your organization has turned on, the sidebar also shows **Ratings**, **Ranking** and the space selector. Below the tree appear the pages that other organizations share with yours and those of your tenants.

### Home

**Home** is the entry screen. It includes:

* **The Teammate box.** Type a question or tell it what has changed. See [Teammate](https://docs.flexxible.com/en/features/flexxible-kb/teammate.md).
* **Pick up where you left off.** The last pages you've read or edited and your chats, with a notice when someone has changed a page since you read it.
* **What's new.** The latest changes by people and agents, each with **Undo**.
* **Waiting for you.** Pages awaiting your validation, if you're a [validator](https://docs.flexxible.com/en/features/flexxible-kb/validation.md) of any.

### Keyboard

Almost everything can be done from the keyboard. `Ctrl` + `K` (`⌘` + `K` on Mac) opens the command palette and `?` shows all shortcuts. See [Keyboard shortcuts](https://docs.flexxible.com/en/features/flexxible-kb/shortcuts.md).

## First steps

**1. Choose your language**

In the organization menu, select **Language**. It changes menus, buttons and messages, for you and on all your devices. Pages stay as they're written.

**2. Write the first page**

Select **New page**, give it a title and start writing. If the knowledge base is empty, **Home** also offers to ask Teammate to draft a "Start here" page.

Before documenting, review [What to write in the knowledge base](https://docs.flexxible.com/en/features/flexxible-kb/writing-guide.md).

**3. Move credentials to the Vault**

Store passwords and keys in the [Vault](https://docs.flexxible.com/en/features/flexxible-kb/vault.md), not in page text. Pages link to them and every use is logged.

**4. Turn on the Flexxible Assist agents**

In **Settings** → **Agents**, turn on Teammate, Solve and Bot so they consult the knowledge base while they work. See [Flexxible Assist agents](https://docs.flexxible.com/en/features/flexxible-kb/assist-agents.md).

**5. Review what's missing**

Once agents start working, [Missing from the KB](https://docs.flexxible.com/en/features/flexxible-kb/gaps.md) will gather what they needed and didn't find. It's the best list of what to write next.

## Next steps

* [Pages](https://docs.flexxible.com/en/features/flexxible-kb/pages.md)
* [Write and edit pages](https://docs.flexxible.com/en/features/flexxible-kb/editor.md)
* [Settings](https://docs.flexxible.com/en/features/flexxible-kb/settings.md)
