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

# Your Aletyx Credentials

> Aletyx issues two unrelated credentials: a Repository Access Token for the Maven repository and Container Registry, and an AI Assistant API key. This page explains which one you need and where to find it.

Aletyx issues **two different credentials**, and they are not interchangeable. Picking the wrong one is the most common setup problem we see, so it is worth thirty seconds to confirm which you need.

## Which one do I need?

|                                            | Repository Access Token                     | AI Assistant API key                          |
| ------------------------------------------ | ------------------------------------------- | --------------------------------------------- |
| **Used for**                               | Maven repository, Container Registry        | Aletyx AI Assistant only                      |
| **How you get it**                         | Issued automatically with your subscription | You create it yourself                        |
| **Where it lives**                         | My Aletyx, **Profile** page                 | My Aletyx, **AI Assistant** then **API Keys** |
| **Requires the AI Assistant subscription** | No                                          | Yes                                           |

<Note>
  **Building with Maven or pulling container images?** You need the Repository Access Token, and you already have it. You do not need the Aletyx AI Assistant, and you do not need to start its free trial.
</Note>

## Repository Access Token

This is the credential for everything in the Aletyx Enterprise Build: the Maven repository, and the container registry. It is created for you when your subscription is set up, so there is nothing to generate and nothing to enable.

<Steps>
  <Step title="Sign in to My Aletyx">
    Go to [my.aletyx.ai](https://my.aletyx.ai) and sign in.
  </Step>

  <Step title="Open your Profile">
    Your token is shown in the **Repository Access Token** field. Click **Copy**.
  </Step>
</Steps>

The token looks like this, with your own email address on the front:

```
email@domain.com|generatedTokenString
```

Treat it like a password. Anyone holding it can pull your artifacts and images.

<Tip>
  For Maven you can usually skip copying the token by hand. In My Aletyx, open **Maven Repository**, click **Maven Instructions**, then **Download settings.xml**. The file arrives with your token already filled in. See [Configuring Maven Settings](/docs/getting-started/maven).
</Tip>

### Using it

<CodeGroup>
  ```xml settings.xml theme={null}
  <server>
    <id>aletyx-maven</id>
    <username>email@domain.com</username>
    <password>email@domain.com|generatedTokenString</password>
  </server>
  ```

  ```bash docker login theme={null}
  echo "email@domain.com|generatedTokenString" | \
    docker login registry.aletyx.services --username your-username --password-stdin
  ```
</CodeGroup>

## AI Assistant API key

This is a separate credential for a separate product. The [Aletyx AI Assistant](/docs/ai-assistant/overview) lets you build and change decision models in natural language, and it has its own subscription with a 14-day free trial.

Unlike the Repository Access Token, you create these keys yourself, and you can hold several of them, name them, and expire or deactivate them independently. Setting one up is covered in [AI Assistant Setup](/docs/ai-assistant/setup).

<Warning>
  An AI Assistant API key will not authenticate you to the Maven repository or the Container Registry, and enabling the AI Assistant does not change your repository access in either direction.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Maven returns 401 Unauthorized">
    Check that the `<password>` in your `settings.xml` is the full token including the `email@domain.com|` prefix. Passing only the part after the pipe fails. If you are unsure, download a fresh `settings.xml` from My Aletyx.
  </Accordion>

  <Accordion title="I cannot find where to generate a Maven token">
    There is nothing to generate. The Repository Access Token already exists on your **Profile** page. The only screen in My Aletyx that creates a token is the AI Assistant's **API Keys** tab, and those keys do not work for Maven.
  </Accordion>

  <Accordion title="Do I need to start the AI Assistant trial?">
    No. The AI Assistant is optional and unrelated to Maven, Files and the Container Registry. Leaving it disabled does not affect your access to any of them.
  </Accordion>

  <Accordion title="I have no token at all">
    Your subscription may not be provisioned yet. [Reach out to us](https://aletyx.ai/contact-us/) and we will sort it out.
  </Accordion>
</AccordionGroup>