# Astrolabe Documentation

> Your Internal Developer Portal. Every page below is plain Markdown: read it at its .md address.

Skills for an AI assistant: https://doc.forgeit.fr/.well-known/skills/index.json

## Administration

- [Change or delete a role](https://doc.forgeit.fr/docs/administration/access-control/change-or-delete-a-role.md): Add or remove people, change the rights, or delete a role.
- [Check what a role gives](https://doc.forgeit.fr/docs/administration/access-control/check-what-a-role-gives.md): Sign in as a person of the role and see what changed on their screens.
- [Create a role](https://doc.forgeit.fr/docs/administration/access-control/create-a-role.md): Name a role, choose who holds it, then give it rights.
- [Access Control FAQ](https://doc.forgeit.fr/docs/administration/access-control/faq.md): The roles that exist at first, who gets what, and how to check.
- [Give administrator rights to someone](https://doc.forgeit.fr/docs/administration/access-control/give-administrator-rights.md): Add a person to the group Astrolabe administrators, or take them out.
- [See the roles and what they give](https://doc.forgeit.fr/docs/administration/access-control/see-the-roles.md): Open the list of roles, see who holds each one and what it gives.
- [Common problems with Access Control](https://doc.forgeit.fr/docs/administration/access-control/troubleshooting.md): What to do when a role cannot be saved or deleted.
- [Choose what the catalog imports](https://doc.forgeit.fr/docs/administration/catalog/choose-what-the-catalog-imports.md): Pick the providers that fill the catalog, narrow what each one reads, and see how their collections went.
- [Catalog FAQ](https://doc.forgeit.fr/docs/administration/catalog/faq.md): Providers, filters, and how often the catalog is read.
- [Run a catalog collection now](https://doc.forgeit.fr/docs/administration/catalog/run-a-collection.md): Start the collection of one provider with its play button, and watch its row go from Running to Done.
- [Common problems with the catalog](https://doc.forgeit.fr/docs/administration/catalog/troubleshooting.md): What to do when a collection fails or finds nothing.
- [Manage access to the demo](https://doc.forgeit.fr/docs/administration/demo-access/manage-demo-access.md): See the requests to enter the public demo, approve or revoke an address, add one by hand and follow a visitor's activity.
- [General FAQ](https://doc.forgeit.fr/docs/administration/general/faq.md): What each tab of Administration › General is for.
- [Go back to an earlier configuration](https://doc.forgeit.fr/docs/administration/general/go-back-to-an-earlier-configuration.md): See what a saved version changed, and restore it.
- [Set the sign-in challenge and usage measurement](https://doc.forgeit.fr/docs/administration/general/set-the-application-settings.md): Fill in the Application tab of Administration › General.
- [Set the documentation address](https://doc.forgeit.fr/docs/administration/general/set-the-documentation-address.md): Choose where the « ? » next to each plugin, integration and card leads, in Administration › General.
- [Set the mail server](https://doc.forgeit.fr/docs/administration/general/set-the-mail-server.md): Give Astrolabe the mail server it sends its messages from.
- [Set the support address](https://doc.forgeit.fr/docs/administration/general/set-the-support-address.md): Tell Astrolabe where a support request goes, in Administration › General.
- [Common problems with General settings](https://doc.forgeit.fr/docs/administration/general/troubleshooting.md): What to do when a save, a restore or a field does not behave as expected.
- [Add your license](https://doc.forgeit.fr/docs/administration/licensing/add-your-license.md): Enter the license key you received from ForgeIT in Administration › Licensing.
- [Licensing FAQ](https://doc.forgeit.fr/docs/administration/licensing/faq.md): What the banner means, what the tabs are, how to renew.
- [Common problems with the license](https://doc.forgeit.fr/docs/administration/licensing/troubleshooting.md): What to do when the key cannot be added.
- [What a license unlocks](https://doc.forgeit.fr/docs/administration/licensing/what-a-license-unlocks.md): The plugins and the sign-in that need a license, and what happens when it lapses.
- [Turn off a plugin](https://doc.forgeit.fr/docs/administration/plugins/turn-off-a-plugin.md): Turn a plugin off in Administration › Plugins.
- [Turn on a plugin](https://doc.forgeit.fr/docs/administration/plugins/turn-on-a-plugin.md): Turn a plugin on in Administration › Plugins, then open its settings.
- [Problems FAQ](https://doc.forgeit.fr/docs/administration/problems/faq.md): What the page lists, how often it is checked, who sees it.
- [Find and fix a problem](https://doc.forgeit.fr/docs/administration/problems/find-and-fix-a-problem.md): See what does not work on your Astrolabe, and go straight to the screen that fixes it.
- [Fix a component whose owner is not found](https://doc.forgeit.fr/docs/administration/problems/fix-a-missing-owner.md): Find the components that name an owner the catalog does not hold, and give them a real one.
- [Common problems with the Problems page](https://doc.forgeit.fr/docs/administration/problems/troubleshooting.md): What the sentences of the page mean and what to do.
- [Check that GitLab reaches Astrolabe](https://doc.forgeit.fr/docs/administration/webhooks/check-that-calls-arrive.md): Read, on the Webhooks tab, whether the calls of GitLab are accepted or refused.
- [Webhooks FAQ](https://doc.forgeit.fr/docs/administration/webhooks/faq.md): What a webhook gives you, and what happens without one.
- [Set the GitLab webhook secret](https://doc.forgeit.fr/docs/administration/webhooks/set-the-webhook-secret.md): Give Astrolabe the secret that GitLab signs its calls with, so Astrolabe can trust them.
- [Common problems with webhooks](https://doc.forgeit.fr/docs/administration/webhooks/troubleshooting.md): What to do when GitLab calls are refused or never arrive.

## Features

- [Manage AI resources](https://doc.forgeit.fr/docs/core-features/ai-resources/administration.md): Read the repositories now, follow what Astrolabe read, list every AI resource, and set the limits of a reading.
- [AI resources FAQ](https://doc.forgeit.fr/docs/core-features/ai-resources/faq.md): Does Astrolabe run my skills, why there is no version, why a runbook has no score.
- [Find and install an AI resource](https://doc.forgeit.fr/docs/core-features/ai-resources/find-and-install.md): Search the AI resources of your company, read one before you use it, and copy the command that installs it in your project.
- [The quality score of AI resources](https://doc.forgeit.fr/docs/core-features/ai-resources/quality-score.md): Read the score of a skill, an agent or a rule, see each check, and correct what fails.
- [Publish your AI resources](https://doc.forgeit.fr/docs/core-features/ai-resources/show-on-a-component.md): Declare a repository in its catalog-info.yaml so its skills, agents, rules and runbooks appear in Astrolabe.
- [Troubleshooting](https://doc.forgeit.fr/docs/core-features/ai-resources/troubleshooting.md): What each message of the AI resources screens means, and what to do.
- [Turn on AI resources](https://doc.forgeit.fr/docs/core-features/ai-resources/turn-on-ai-resources.md): Turn on the AI resources plugin, so your teams find the skills, agents and rules of your repositories.
- [Announcements FAQ](https://doc.forgeit.fr/docs/core-features/announcements/faq.md): Who sees an announcement, and what a draft is.
- [Publish an announcement](https://doc.forgeit.fr/docs/core-features/announcements/publish-an-announcement.md): Write an announcement, choose who reads it and publish it.
- [Read the announcements](https://doc.forgeit.fr/docs/core-features/announcements/read-announcements.md): Open the announcements your company sent you: a maintenance, a new feature.
- [Common problems with announcements](https://doc.forgeit.fr/docs/core-features/announcements/troubleshooting.md): What each message of the announcements screens means, and what to do.
- [Browse the catalog](https://doc.forgeit.fr/docs/core-features/catalog/browse-the-catalog.md): Open the catalog, switch between components, APIs, systems and teams, and open the page of one of them.
- [Catalog FAQ](https://doc.forgeit.fr/docs/core-features/catalog/faq.md): What the catalog lists, what the search by name looks at, and how to find a team.
- [Filter the catalog](https://doc.forgeit.fr/docs/core-features/catalog/filter-the-catalog.md): Find a component by its name, its owner, its lifecycle or its tags.
- [Register an existing component](https://doc.forgeit.fr/docs/core-features/catalog/register-a-component.md): Add a component to the catalog from the URL of its catalog-info.yaml file.
- [Star a component](https://doc.forgeit.fr/docs/core-features/catalog/star-a-component.md): Put the components you use every day in your favorites, and list only them.
- [Common problems with the catalog](https://doc.forgeit.fr/docs/core-features/catalog/troubleshooting.md): What each message of the catalog screens means, and what to do.
- [Add the Compass card to your dashboard](https://doc.forgeit.fr/docs/core-features/compass/add-the-dashboard-card.md): See the scores of the components of the catalog on My Dashboards.
- [Create a compass](https://doc.forgeit.fr/docs/core-features/compass/create-a-compass.md): Write your own rules, group them in a compass, and turn it on.
- [Frequently asked questions](https://doc.forgeit.fr/docs/core-features/compass/faq.md): Answers about Compass scores, compasses and campaigns.
- [Run a campaign](https://doc.forgeit.fr/docs/core-features/compass/run-a-campaign.md): Follow a rule across your components until a deadline, and see what still fails.
- [See the score of a component](https://doc.forgeit.fr/docs/core-features/compass/see-the-score-of-a-component.md): Read the score of a component and see which rules pass or fail.
- [See the scores of all components](https://doc.forgeit.fr/docs/core-features/compass/see-the-scores-of-all-components.md): Compare the scores of every component in one table, and filter it.
- [Common problems with Compass](https://doc.forgeit.fr/docs/core-features/compass/troubleshooting.md): What the Compass screens say when something is missing, and what to do.
- [Turn on Compass](https://doc.forgeit.fr/docs/core-features/compass/turn-on-compass.md): Turn on the Compass plugin to score your components against rules you choose.
- [Common problems with Cost Insights](https://doc.forgeit.fr/docs/core-features/cost-insights/troubleshooting.md): What the Cost Insights screens say when something is missing, and what to do.
- [Turn on Cost Insights](https://doc.forgeit.fr/docs/core-features/cost-insights/turn-on-cost-insights.md): Turn on Cost Insights and connect it to the AWS account whose costs you want to see.
- [Add the Deployments card to your dashboard](https://doc.forgeit.fr/docs/core-features/deployments/add-the-dashboard-card.md): See the versions deployed on each environment for the components of the catalog, on My Dashboards.
- [Frequently asked questions](https://doc.forgeit.fr/docs/core-features/deployments/faq.md): Answers about Deployments and Argo CD.
- [Read the versions in Argo CD](https://doc.forgeit.fr/docs/core-features/deployments/read-from-argo-cd.md): Let Astrolabe read the version Argo CD deployed for each component, on each environment, from two labels on your Argo CD applications.
- [Report deployments from your pipelines](https://doc.forgeit.fr/docs/core-features/deployments/report-from-pipelines.md): Give your pipelines a token so each deployment shows its version in Astrolabe.
- [See the versions deployed](https://doc.forgeit.fr/docs/core-features/deployments/see-deployed-versions.md): Which version of each component runs on each environment, on one page and on each component.
- [Common problems with Deployments](https://doc.forgeit.fr/docs/core-features/deployments/troubleshooting.md): What the messages of the Deployments screens mean, and what to do.
- [Change or delete a group](https://doc.forgeit.fr/docs/core-features/groups/change-or-delete-a-group.md): Change the title, the members or the parent of a group, or delete it.
- [Create a group](https://doc.forgeit.fr/docs/core-features/groups/create-a-group.md): Create a team, give it members and a parent, so it can own components and receive roles.
- [Groups FAQ](https://doc.forgeit.fr/docs/core-features/groups/faq.md): What a group is for, and where to see it.
- [See a group and its members](https://doc.forgeit.fr/docs/core-features/groups/see-a-group.md): Open the page of a team to see its members and everything it owns.
- [Common problems with groups](https://doc.forgeit.fr/docs/core-features/groups/troubleshooting.md): What each message of the groups screens means, and what to do.
- [Choose your language and your theme](https://doc.forgeit.fr/docs/core-features/my-account/choose-language-and-theme.md): Switch Astrolabe between English and French, and between the light and the dark theme.
- [Connect your own accounts](https://doc.forgeit.fr/docs/core-features/my-account/connect-my-accounts.md): See, add or remove your own accounts on the tools your company connected to Astrolabe.
- [My account FAQ](https://doc.forgeit.fr/docs/core-features/my-account/faq.md): Where to find your language, your theme and your tokens.
- [Open your account](https://doc.forgeit.fr/docs/core-features/my-account/open-my-account.md): Open My Account from the menu of your avatar and see what each tab holds.
- [See your achievements](https://doc.forgeit.fr/docs/core-features/my-account/see-my-achievements.md): Follow your level and the achievements you unlocked by using Astrolabe.
- [Common problems with My Account](https://doc.forgeit.fr/docs/core-features/my-account/troubleshooting.md): What each message of the account screens means, and what to do.
- [Ask Polaris a question](https://doc.forgeit.fr/docs/core-features/polaris/ask-polaris.md): Open Polaris from the sidebar, ask a question, and find your conversations again.
- [Common problems with Polaris](https://doc.forgeit.fr/docs/core-features/polaris/troubleshooting.md): What to do when Polaris says it is not configured or cannot answer.
- [Turn on Polaris](https://doc.forgeit.fr/docs/core-features/polaris/turn-on-polaris.md): Turn on the Polaris plugin and enter the address and the token of its AI server.
- [Search FAQ](https://doc.forgeit.fr/docs/core-features/search/faq.md): What the search covers and what it does not.
- [Search Astrolabe](https://doc.forgeit.fr/docs/core-features/search/search-astrolabe.md): Type a word and find the components, APIs, systems, teams and templates that hold it in their name or description.
- [Common problems with search](https://doc.forgeit.fr/docs/core-features/search/troubleshooting.md): What each message of the search screen means, and what to do.
- [Add entries to the radar](https://doc.forgeit.fr/docs/core-features/tech-atlas/add-entries.md): Add the technologies of your radar, and move them between rings over time.
- [Frequently asked questions](https://doc.forgeit.fr/docs/core-features/tech-atlas/faq.md): Answers about the Tech Atlas radar, rings and entries.
- [Read the radar](https://doc.forgeit.fr/docs/core-features/tech-atlas/read-the-radar.md): See what your company recommends, quadrant by quadrant and ring by ring.
- [Common problems with Tech Atlas](https://doc.forgeit.fr/docs/core-features/tech-atlas/troubleshooting.md): What the Tech Atlas screens say when something is missing, and what to do.
- [Turn on Tech Atlas](https://doc.forgeit.fr/docs/core-features/tech-atlas/turn-on-tech-atlas.md): Turn on the technology radar and create its rings.
- [Add documentation to a component](https://doc.forgeit.fr/docs/core-features/techdocs/add-docs-to-a-component.md): Give a component the annotation that makes its Docs tab show its documentation.
- [Documentation FAQ](https://doc.forgeit.fr/docs/core-features/techdocs/faq.md): Which components appear in Documentation, and where to find a document.
- [Read the documentation of a component](https://doc.forgeit.fr/docs/core-features/techdocs/read-component-docs.md): Open the technical documentation of a component, from the Documentation page or from the component.
- [Common problems with the documentation](https://doc.forgeit.fr/docs/core-features/techdocs/troubleshooting.md): What each message of the documentation screens means, and what to do.
- [Create a component from a template](https://doc.forgeit.fr/docs/core-features/the-foundry/create-a-component.md): Pick a template in The Foundry, fill in its form, and start the creation.
- [The Foundry FAQ](https://doc.forgeit.fr/docs/core-features/the-foundry/faq.md): Where to see the templates, and what the other tabs are for.
- [Follow the creation of a component](https://doc.forgeit.fr/docs/core-features/the-foundry/follow-a-task.md): Watch the steps of a creation, read their logs, and find your past creations.
- [Common problems with The Foundry](https://doc.forgeit.fr/docs/core-features/the-foundry/troubleshooting.md): What each message of The Foundry means, and what to do.

## Dashboard and notifications

- [Add a card](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/add-a-card.md): Pick a source, a key and a dashboard to put a card on it.
- [Arrange your cards](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/arrange-your-cards.md): Move and resize the cards of a dashboard, or move cards to another dashboard.
- [Change or remove a card](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/change-or-remove-a-card.md): Rename a card, choose its columns, read its source again, or delete it.
- [Choose how many results a card shows](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/choose-how-many-results.md): Show 5, 10, 25 or 50 rows at a time under a card of My Dashboards. Astrolabe remembers your choice.
- [Create a dashboard](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/create-a-dashboard.md): Add a tab to My Dashboards with the + button, and give it a name.
- [Follow the critical notifications of your dashboards](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/critical-notifications.md): See which dashboard holds unread critical notifications, and open a notification on its card.
- [Delete a dashboard](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/delete-a-dashboard.md): Remove a tab and its cards, except your last dashboard.
- [Dashboard FAQ](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/faq.md): Who sees my dashboard, how cards stay fresh, and what to do with an empty one.
- [See your dashboard full screen](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/full-screen.md): Hide the menus and keep only your cards, for a wall screen or a meeting.
- [Read a card's source again](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/refresh-a-card.md): Use Refresh in the menu of a card to read its source now, instead of waiting for the next automatic read.
- [Rename a dashboard](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/rename-a-dashboard.md): Change the name of a tab by double-click, F2 or the options menu.
- [Put your dashboards in order](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/reorder-your-dashboards.md): Move a tab to the left or to the right.
- [Common problems with the dashboard](https://doc.forgeit.fr/docs/developer-dashboard/my-dashboard/troubleshooting.md): What to do when a card is empty or asks you to connect an account.
- [Choose your notifications](https://doc.forgeit.fr/docs/developer-dashboard/notifications/choose-your-notifications.md): Pick, tool by tool, the events Astrolabe tells you about, in Astrolabe and on your browser.
- [Delete the notifications you have read](https://doc.forgeit.fr/docs/developer-dashboard/notifications/delete-read-notifications.md): Remove one read notification, or all the read ones, from your history. Notifications you have not read are never deleted.
- [Notifications FAQ](https://doc.forgeit.fr/docs/developer-dashboard/notifications/faq.md): Which events, why some are off, one browser or all.
- [Read your notifications](https://doc.forgeit.fr/docs/developer-dashboard/notifications/read-your-notifications.md): Open the bell, read what Astrolabe tells you, filter it and mark it as read.
- [Common problems with notifications](https://doc.forgeit.fr/docs/developer-dashboard/notifications/troubleshooting.md): What each message of the notifications screen means, and what to do.
- [Receive notifications on this browser](https://doc.forgeit.fr/docs/developer-dashboard/notifications/turn-on-this-browser.md): Let your browser show Astrolabe's notifications, even with the tab closed.
- [Watch a component](https://doc.forgeit.fr/docs/developer-dashboard/notifications/watch-a-component.md): Hear of everything that happens to a component, even one your team does not own.

## Getting started and configuration

- [Reset the administrator password](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/astrolabe-account/reset-the-password.md): Ask Astrolabe to send a verification code to the administrator email address.
- [Sign in with your Astrolabe account](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/astrolabe-account/sign-in.md): Sign in to Astrolabe with the administrator username and password, and sign out.
- [Add Atlassian](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/atlassian/add-atlassian.md): Turn on Atlassian in Administration › Authentication.
- [Create the Atlassian OAuth 2.0 app](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/atlassian/create-the-atlassian-app.md): Create an OAuth 2.0 integration in the Atlassian developer console, and copy its Client ID and Secret.
- [Add Auth0 sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/auth0/add-auth0-sign-in.md): Turn on Auth0 in Administration › Authentication, and see the Continue with Auth0 button on the sign-in page.
- [Create the Auth0 application](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/auth0/create-the-auth0-app.md): Create a Regular Web Application in Auth0, and copy its Domain, Client ID and Client Secret.
- [Choose how people sign in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/authentification.md): Sign in with the Astrolabe administrator account, or turn on a provider such as Google or Auth0 from Administration › Authentication.
- [Authentication FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/faq.md): Several providers, the password form, grayed buttons, and where to turn a provider on or off.
- [Configure GitHub sign-in in Astrolabe](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/github/configure-github-sign-in.md): Enter the Client ID and Client Secret of your GitHub OAuth app in Administration › Authentication.
- [Create the OAuth app in GitHub](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/github/create-the-oauth-app.md): GitHub sign-in needs an OAuth app that gives you a Client ID and a Client Secret.
- [GitHub sign-in FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/github/faq.md): Callback address, GitHub Enterprise.
- [Sign in with GitHub](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/github/sign-in-with-github.md): Use the Continue with GitHub button of the sign-in page.
- [Common problems with GitHub sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/github/troubleshooting.md): What to do when the form refuses the values or the sign-in button is disabled.
- [Configure GitLab sign-in in Astrolabe](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/gitlab/configure-gitlab-sign-in.md): Enter the Application ID and the Secret of your GitLab application in Administration › Authentication.
- [Create the GitLab application](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/gitlab/create-the-oauth-app.md): GitLab sign-in needs an application that gives you an Application ID and a Secret.
- [GitLab sign-in FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/gitlab/faq.md): Callback address, your own GitLab, where to read the settings again.
- [Sign in with GitLab](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/gitlab/sign-in-with-gitlab.md): Use the GitLab button of the sign-in page.
- [Common problems with GitLab sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/gitlab/troubleshooting.md): What to do when the form refuses the values, or when the GitLab connection does not answer.
- [Add Google sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/google/add-google-sign-in.md): Turn on Google in Administration › Authentication, and see the Continue with Google button on the sign-in page.
- [Create the Google OAuth client](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/google/create-the-google-app.md): Create an OAuth client in Google Cloud, and copy its Client ID and Client Secret.
- [Microsoft sign-in FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/microsoft/faq.md): The redirect URL, the license, the domain hint.
- [Set up the Microsoft sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/microsoft/set-up-sign-in.md): Add the Microsoft provider in Administration › Authentication so your users can click Continue with Microsoft.
- [Common problems with the Microsoft sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/microsoft/troubleshooting.md): What to do when the Microsoft button is greyed or the provider is missing.
- [Add Okta](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/okta/add-okta.md): Turn on Okta in Administration › Authentication.
- [Create the Okta application](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/okta/create-the-okta-app.md): Create a web application in Okta, and copy its Client ID and Client secret.
- [Request access when sign-in is refused](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/request-access.md): Ask an administrator for access when a provider sign-in is refused, because you have no license or because Astrolabe does not know your account.
- [Common problems with sign-in](https://doc.forgeit.fr/docs/getting-started/Configuration/Authentication/troubleshooting.md): What to do when sign-in fails, when the buttons are grayed, or when the password reset does not start.
- [Azure DevOps catalog FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/azure-devops/faq.md): How often the catalog reads Azure DevOps, which token it uses, and how to import only some projects or repositories.
- [Import your Azure DevOps repositories](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/azure-devops/import-repositories.md): Every Azure DevOps repository with a catalog-info.yaml file shows up in the Astrolabe catalog, collected every 30 minutes.
- [Common problems with the Azure DevOps catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/azure-devops/troubleshooting.md): What to do when the Azure DevOps provider cannot be configured or its collection fails.
- [Bitbucket Cloud catalog FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-cloud/faq.md): How often the catalog reads Bitbucket Cloud, which token it uses, and how to import only some repositories.
- [Import your Bitbucket Cloud repositories](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-cloud/import-repositories.md): Every repository of your Bitbucket Cloud workspace with a catalog-info.yaml file shows up in the Astrolabe catalog, collected every 30 minutes.
- [Common problems with the Bitbucket Cloud catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-cloud/troubleshooting.md): What to do when the Bitbucket Cloud provider cannot be configured or its collection fails.
- [Bitbucket Server catalog FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-server/faq.md): How often the catalog reads Bitbucket Server, and how to import only some repositories.
- [Import your Bitbucket Server repositories](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-server/import-repositories.md): Every repository of your Bitbucket Server with a catalog-info.yaml file shows up in the Astrolabe catalog, collected every 30 minutes.
- [Common problems with the Bitbucket Server catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/bitbucket-server/troubleshooting.md): What to do when the Bitbucket Server provider cannot be configured or its collection fails.
- [GitHub catalog FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/github/faq.md): Answers to the most common questions on importing GitHub repositories.
- [Import your GitHub repositories](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/github/import-repositories.md): Every repository of a GitHub organization with a catalog-info.yaml file shows up in the Astrolabe catalog, collected every 30 minutes.
- [Common problems with the GitHub catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/github/troubleshooting.md): What to do when a GitHub repository does not show up in the catalog or the collection fails.
- [Questions about GitLab owners](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/gitlab/faq.md): Answers to the most common questions on importing GitLab groups and naming a component's owner.
- [Give a component its GitLab owner](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/gitlab/give-an-owner.md): Write the right group name in the owner field of catalog-info.yaml, and find it in the catalog when in doubt.
- [Import your GitLab groups](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/gitlab/import-groups.md): Bring your GitLab groups and their members into the catalog, so that each component can name its real owner.
- [Import your GitLab projects](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/gitlab/import-projects.md): Every GitLab project with a catalog-info.yaml file shows up in the Astrolabe catalog, collected every 30 minutes.
- [Common problems with the GitLab catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/gitlab/troubleshooting.md): What to do when a GitLab group, a component or its owner does not show up in the catalog.
- [Microsoft Entra ID FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/microsoft-entra-id/faq.md): Which permissions, where to see the result of a collection, how to change the credentials.
- [Import your Entra ID users and groups](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/microsoft-entra-id/import-users-and-groups.md): The Microsoft Graph provider reads the users and groups of Microsoft Entra ID and adds them to the Astrolabe catalog.
- [Common problems with the Microsoft Entra ID catalog](https://doc.forgeit.fr/docs/getting-started/Configuration/Catalogue/microsoft-entra-id/troubleshooting.md): What to do when the Microsoft Graph collection fails or does not start.
- [Add the Applications card to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/add-the-dashboard-card.md): List the Argo CD applications of the components of the catalog on My Dashboards.
- [Add the Argo CD integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/add-the-integration.md): Enter your Argo CD host and token in Administration › Company connections, and test the connection.
- [Create a read-only Argo CD token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/create-a-token.md): Astrolabe reads Argo CD with the API token of a dedicated account. Create the account and its token first.
- [Argo CD FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/faq.md): Several applications per component, what the dashboard card lists, which token rights.
- [Show the Argo CD tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/show-the-tab.md): Turn on the Argo CD plugin and annotate your components to see their deployment.
- [Common problems with Argo CD](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/argocd/troubleshooting.md): What to do when the connection test fails or the Argo CD tab is missing.
- [Add the AWS integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/aws/add-the-integration.md): Enter an AWS account number, a region and an access key in Administration › Company connections, and test the connection.
- [Common problems with AWS](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/aws/troubleshooting.md): What each message of the integration form means, and what to do.
- [Add the Azure costs card to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/add-the-dashboard-card.md): Follow the cost of your subscription, service by service, on My Dashboards.
- [Add the Azure Cloud integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/add-the-integration.md): Enter the tenant, the app registration and the subscription in Administration › Company connections, and test the connection.
- [Prepare an Azure service principal](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/create-a-service-principal.md): Astrolabe reads your Azure subscription with an app registration that has the Reader and Cost Management Reader roles.
- [Azure Cloud FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/faq.md): Which roles, why a component has no Azure tab, what the costs are.
- [Show Azure on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/show-on-a-component.md): Turn on the Azure plugin and annotate a component with a tag to see its Azure resources and costs.
- [Common problems with Azure Cloud](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-cloud/troubleshooting.md): What to do when the connection test fails or a component shows no resources.
- [Add the Azure DevOps cards to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-devops/add-the-dashboard-cards.md): Follow your pipelines, pull requests and work items on My Dashboards, with your own Azure DevOps token.
- [Add the Azure DevOps integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-devops/add-the-integration.md): Enter your Azure DevOps host, organization and the company token in Administration › Company connections, and test the connection.
- [Create an Azure DevOps token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-devops/create-a-token.md): Astrolabe reads Azure DevOps with a personal access token, one for the company and one per user.
- [Azure DevOps FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-devops/faq.md): Which token, why a card asks you to connect your account, where the Azure DevOps tab is.
- [Common problems with Azure DevOps](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/azure-devops/troubleshooting.md): What to do when the connection test fails or a dashboard card asks for a token.
- [Add the Bitbucket Cloud integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/bitbucket-cloud/add-the-integration.md): Enter the email and the token of your Bitbucket Cloud account in Administration › Company connections, and test the connection.
- [Common problems with Bitbucket Cloud](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/bitbucket-cloud/troubleshooting.md): What each message of the integration form means, and what to do.
- [Add the Bitbucket Server integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/bitbucket-server/add-the-integration.md): Enter the address of your Bitbucket Server and an access token in Administration › Company connections, and test the connection.
- [Common problems with Bitbucket Server](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/bitbucket-server/troubleshooting.md): What each message of the integration form means, and what to do.
- [Add the Codacy integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/codacy/add-the-integration.md): Enter a Codacy account API token in Administration › Company connections, and test the connection.
- [Show Codacy on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/codacy/show-on-a-component.md): Turn on the Codacy plugin and annotate your components to see their grade and their issues.
- [Common problems with Codacy](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/codacy/troubleshooting.md): What to do when the connection test fails or the Codacy card and tab are missing.
- [The company's token and your own account](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/company-token-and-my-account.md): Two tokens, two uses. The company's token in Administration › Company connections, your own account from the card that needs it.
- [Add the Confluence integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/confluence/add-the-integration.md): Connect Confluence to Astrolabe so that its pages are found by the search, in 5 minutes.
- [Find a Confluence page in the search](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/confluence/search-confluence-pages.md): Type a word of a Confluence page in the search of Astrolabe and open the page.
- [Common problems with Confluence](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/confluence/troubleshooting.md): What each message of the Confluence form, the Problems screen and the search means, and what to do.
- [Add the GitHub cards to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/add-the-dashboard-cards.md): Follow your workflows, pull requests and releases on My Dashboards, with your own GitHub token.
- [Add the GitHub integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/add-the-integration.md): Enter your GitHub host and the administrator's token in Administration › Company connections, and test the connection.
- [Create a GitHub token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/create-a-token.md): Astrolabe reads GitHub with a classic personal access token with the repo, read:org and read:user scopes.
- [GitHub FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/faq.md): Missing tab, your own pull requests, which token rights, which repositories on the cards.
- [Get GitHub notifications](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/get-notifications.md): Be told in Astrolabe when a workflow fails or a pull request needs you, and choose which GitHub events you receive.
- [Show the GitHub tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/show-the-tab.md): Turn on the GitHub plugin and annotate your components to see their pipelines, pull requests and branches.
- [Common problems with GitHub](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/github/troubleshooting.md): What to do when the connection test fails, the GitHub tab is missing or a card stays empty.
- [Add the GitLab cards to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/add-the-dashboard-cards.md): Add a GitLab card to My Dashboards, then connect your own GitLab account from the card itself.
- [Add the GitLab integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/add-the-integration.md): Enter your GitLab host and the administrator's token in Administration › Company connections, and test the connection.
- [Create a GitLab token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/create-a-token.md): Astrolabe reads GitLab with a personal access token with the read_api and read_repository scopes.
- [GitLab FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/faq.md): Missing tab, your own merge requests, empty cards, which token rights.
- [Get GitLab notifications](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/get-notifications.md): Be told in Astrolabe when a pipeline fails or a merge request needs you, and choose which GitLab events you receive.
- [Show the GitLab tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/show-the-tab.md): Turn on the GitLab plugin and annotate your components to see their pipelines, merge requests and branches.
- [Common problems with GitLab](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/troubleshooting.md): What to do when the connection test fails, the GitLab tab is missing or a card stays empty.
- [What each GitLab card shows](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/gitlab/what-the-cards-show.md): For each GitLab card of My Dashboards, which projects it reads, its columns, and what it says when there is nothing to show.
- [Add the Alerts in trouble card to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/add-the-alerts-card.md): List the Grafana alert rules that fire, are in error or get no data, on My Dashboards.
- [Add the Grafana integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/add-the-integration.md): Enter the address of Grafana and its service account token in Administration › Company connections, and test the connection.
- [Create a Grafana service account token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/create-a-token.md): Astrolabe reads Grafana with a service account token that has the Viewer role. Create it in Grafana first.
- [Grafana FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/faq.md): Which token, who sees what, and where Grafana is entered.
- [Show the Monitoring tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/show-the-monitoring-tab.md): Turn on the Grafana plugin and annotate your components so they show their alerts and dashboard panels.
- [Common problems with Grafana](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/grafana/troubleshooting.md): What to do when the connection test fails, or the Monitoring tab or the card shows an error.
- [Overview](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration.md): Which tools Astrolabe connects to, what each one brings, and where to start.
- [Add the Jenkins cards to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/add-the-dashboard-cards.md): Follow the builds of your components on My Dashboards, with the Builds and Detailed Builds cards.
- [Add the Jenkins integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/add-the-integration.md): Give Astrolabe your Jenkins address, user and token, in Administration › Company connections.
- [Create a Jenkins API token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/create-a-token.md): Astrolabe reads Jenkins with a user name and an API token. Create the token in Jenkins first.
- [Jenkins FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/faq.md): Which token, who sees what, several Jenkins, several jobs.
- [Show the Jenkins tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/show-the-tab.md): Turn on the Jenkins plugin and annotate a component to see its builds.
- [Common problems with Jenkins](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jenkins/troubleshooting.md): What each message of the integration form means, and what to do when the Jenkins tab stays empty.
- [Add your Jira issues to your dashboard](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/add-the-dashboard-cards.md): Add a Jira card to My Dashboards, then connect your own Jira account from the card itself.
- [Connect Jira Cloud](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/connect-jira-cloud.md): Your Jira address ends in .atlassian.net? Connect it with an e-mail and an API token, in 5 minutes.
- [Connect your company's Jira (Data Center)](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/connect-jira-data-center.md): Your Jira has its own address, like https://jira.example.com? Connect it with a personal access token, in 5 minutes.
- [Jira FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/faq.md): Cloud or Data Center, which rights, which token for what, what the cards list.
- [Get Jira notifications](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/get-notifications.md): Be told in Astrolabe about the comments, status changes and assignments of your Jira issues, and choose which events you receive.
- [Show the Jira tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/show-the-tab.md): Turn on the Jira plugin and annotate a component to list its project's open issues.
- [Common problems with Jira](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/troubleshooting.md): What each message of the Jira forms and cards means, and what to do.
- [What each Jira card shows](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/jira/what-the-cards-show.md): For each Jira card of My Dashboards, which issues it lists, its columns (Type, Priority, Status, Estimate, Sprint), and what it says when there is nothing to show.
- [Add the LaunchDarkly integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/launchdarkly/add-the-integration.md): Enter the LaunchDarkly API URL and an access token in Administration › Company connections, and test the connection.
- [Show the LaunchDarkly tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/launchdarkly/show-on-a-component.md): Turn on the LaunchDarkly plugin, enter its API address and key, and annotate your components.
- [Common problems with LaunchDarkly](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/launchdarkly/troubleshooting.md): What to do when the connection test fails or the LaunchDarkly tab shows no flags.
- [Add the SonarQube integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/sonarqube/add-the-integration.md): Give Astrolabe your SonarQube address and token, in Administration › Company connections.
- [Create a SonarQube token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/sonarqube/create-a-token.md): Create the user token Astrolabe reads SonarQube with, in 2 minutes.
- [SonarQube FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/sonarqube/faq.md): Which token, who sees what, several SonarQube, SonarQube Cloud.
- [Show SonarQube on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/sonarqube/show-on-a-component.md): Turn on the SonarQube plugin and annotate a component to see its code quality.
- [Common problems with SonarQube](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/sonarqube/troubleshooting.md): What each message of the integration form and of the Code Quality card means, and what to do.
- [Add the Terraform Cloud integration](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/terraform/add-the-integration.md): Enter the address of Terraform Cloud and your API token in Administration › Company connections, and test the connection.
- [Create a Terraform Cloud API token](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/terraform/create-a-token.md): Astrolabe reads Terraform Cloud with an API token. Create it in Terraform Cloud first.
- [Terraform Cloud FAQ](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/terraform/faq.md): Which token, who sees what, and where Terraform Cloud is entered.
- [Show the Terraform tab on a component](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/terraform/show-the-tab.md): Turn on the Terraform plugin and annotate your components so they show their workspaces and last runs.
- [Common problems with Terraform Cloud](https://doc.forgeit.fr/docs/getting-started/Configuration/Integration/terraform/troubleshooting.md): What to do when the connection test fails or the Terraform tab shows an error.
- [Configure Astrolabe](https://doc.forgeit.fr/docs/getting-started/configure-astrolabe.md): The steps to make a new Astrolabe ready for your teams, in order.
- [Install Astrolabe](https://doc.forgeit.fr/docs/getting-started/install-astrolabe.md): The two ways to get Astrolabe, hosted by ForgeIT (SaaS) or in your own infrastructure (on-prem), and how to try it in one command.
- [Ask for access to the demo](https://doc.forgeit.fr/docs/getting-started/request-demo-access.md): Ask for access to the Astrolabe demo, confirm your address with a code, and enter.

## Start here

- [Welcome](https://doc.forgeit.fr/docs/intro.md): Everything you need to set up Astrolabe and use it every day.
- [Use this documentation with your AI assistant](https://doc.forgeit.fr/docs/use-with-an-ai-assistant.md): Install the Astrolabe skills in Claude Code or Cursor, and let your assistant read the documentation.