> For the complete documentation index, see [llms.txt](https://help.ica.illumina.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ica.illumina.com/readme/gs-getstarted.md).

# Get Started

## Set up your organization

### Software Registration

If you are a new user, please consult the [Illumina BioInsight Platform Registration Guide](https://help.connected.illumina.com/account-management/rg-registration) for detailed guidance on setting up an account and registering a subscription.

### Tenant Setup

Platform Core requires a provisioned tenant in [**Illumina Account Management**](https://help.connected.illumina.com/account-management/admin-console) ([IAM](https://help.connected.illumina.com/account-management/admin-console)). When a tenant is provisioned, a **tenant administrator** is assigned. Tenant administrators can manage account access, including adding users, creating workgroups, and adding additional tenant administrators.

Each tenant is assigned a domain name used to access their login page:

`https://<domain_name>.login.illumina.com` with `<domain_name>` replaced by the actual domain name assigned to your tenant.

### Add users to the tenant

A user account can be added to the tenant in either of the following ways:

* **Tenant administrator**: Sign in to the domain and select **Illumina Account Management** from the profile menu in the top right.
* **User**: Go to `https://platform.login.illumina.com` and select **Don't have an account**.

After the user has been added to the tenant, a tenant administrator can assign the user to a [workgroup](https://help.connected.illumina.com/account-management/admin-console/workgroups). Workgroups grant users permission to use Platform Core. Registered users can be made workgroup administrators by tenant administrators or existing workgroup administrators.

***

## Choose how to access Platform Core

<details>

<summary>Access via Web UI</summary>

The web application provides a visual user interface (UI) for navigating resources in the platform, managing projects, and extended features beyond the API.

To access the web application:

1. Navigate to the [Illumina BioInsight Platform Core portal](https://ica.illumina.com/ica).
2. Sign in with your Illumina account.
3. Confirm you can access your tenant.

You're now ready to use Platform Core. Go to [Platform Core Home](/web-ui-access/platform-core-home.md) to become familiar with the interface and begin working.

</details>

<details>

<summary>Access via CLI</summary>

The Platform Core command-line interface (CLI) provides command-line access to Platform Core resources and workflows.

To access Platform Core through the CLI:

1. Download and install the CLI for your operating system. See [CLI Installation](/cli-access/cli-installation.md).
2. Configure authentication. Create an API key and configure a CLI profile for your Platform Core environment. See [CLI Authentication](/cli-access/cli-authentication.md).
3. Verify your access. Run command to confirm that the CLI can connect to your Platform Core tenant. See [Command Index](/cli-access/cli-indexcommands.md).

You're now ready to use the Platform Core CLI.

</details>

<details>

<summary>Access via API</summary>

Platform Core provides HTTP-based APIs for programmatic access to platform resources. See the [Swagger API Reference](https://ica.illumina.com/ica/api/swagger/index.html) for available APIs, schemas, and endpoints.

To access Platform Core through the API:

1. Create an API key. See[ Managing API Keys](https://help.connected.illumina.com/account-management/platform-home#manage-api-keys).
2. Authenticate and obtain a JSON Web Token (JWT).
3. Verify your access by making an authenticated API request using the Swagger API Reference.

You're now ready to use the Platform Core API. Go to [API](/api-access/r-api.md) to learn more about API access.

</details>

{% hint style="warning" %}
If you have intrusion detection systems active on your infrastructure, be aware that activities performed by Platform Core on your behalf (such as accessing [your own S3 storage](/web-ui-access/h-storage/s-awss3.md) ) might trigger suspicious activity alerts. Please review the alerts and rules with your vendor to set up appropriate policies on your detection system.
{% endhint %}


---

# 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.ica.illumina.com/readme/gs-getstarted.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.