# Connect a Project Source

Connect a supported project source to an Atloria project so Atloria can analyze the project and make its source available for project-level work. This connection is also required before you can verify that Atloria can reach the source.

## Overview

A project source is the codebase or other supported source location that Atloria uses for source analysis. You connect the source while creating a project or manage the connection later from the project’s **Source** area.

Use this process when you are setting up a new project, changing the source associated with an existing project, or confirming that Atloria can access a source after connection details have changed. The **Test Connection** action helps you verify the connection before relying on source analysis results.

After a source is connected and processing completes, Atloria can use the project source as the basis for analysis. If a connection is no longer needed, you can remove it with **Disconnect**. Disconnecting a source prevents further work that depends on that project’s connected source until you connect one again.

> 📷 _Screenshot pending: The Projects area showing the New Project action and a project’s Source option._

## Prerequisites

Before you begin, make sure you have:

- Access to the Atloria **Projects** area.
- Permission to create or manage the target project.
- A supported project source that your organization is authorized to connect.
- The source location and any access information required by your organization’s source provider.
- A decision about whether you are creating a **New Project** or updating an existing project.
- Network and access permissions that allow Atloria to reach the selected source.

## Step-by-Step Instructions

### Connect a source while creating a project

1. Select **Projects** to open the list of available projects.

2. Select **New Project** to start creating a project.

3. Enter the required project information on the new-project screen.

4. Provide the source connection information required for the supported source you want to connect.

5. Select **Create project** to create the project with the source connection.

6. Select **⚡ Test Connection** to check whether Atloria can reach the connected source.

7. Review the connection result before proceeding with source analysis.

8. Select **Open Project Dashboard** to return to the project after the connection has been verified.

### Connect or verify a source for an existing project

1. Select **Projects** to open the project list.

2. Use **Search projects...** to find the project you want to update.

3. Select the project to make it the active project.

4. Select **Source** from the project options.

5. Enter or update the connection information for the supported source.

6. Select **Test Connection** to verify access to the source.

7. Review the test result and correct the source information if the connection is not successful.

8. Select **View Source** when you need to inspect the connected source from the project.

> 📷 _Screenshot pending: The Source area for an active project, including Test Connection, View Source, and Disconnect actions._

### Disconnect a project source

1. Open the project that currently has the source connection.

2. Select **Source**.

3. Select **Disconnect** to remove the source connection from the project.

4. Confirm the disconnect action if Atloria asks you to confirm it.

5. Return to **Projects** when you are finished managing the project connection.

## Tips and Best Practices

- Test the connection immediately after creating the project or changing source details. Selecting **Test Connection** early helps you identify access problems before you expect source analysis to run.

- Use **Search projects...** when your organization has many projects. This helps you avoid changing the source connection for the wrong project.

- Confirm that you are working in the intended active project before selecting **Disconnect**. A disconnect removes the project’s current source association and can interrupt work that depends on source access.

- Use **View Source** as a quick check that you are working with the expected project source after a successful connection.

- If analysis completes with warnings, review the source connection and source contents before assuming all source material was processed as expected. A completed analysis can require follow-up when warnings are present.

- Keep project-source ownership clear within your team. Limit source connection changes to administrators or users who understand the project’s intended source and access requirements.

## Related Pages

- [Create a Project](#)
- [Manage Projects](#)
- [Test a Source Connection](#)
- [View Project Source](#)
- [Run Source Analysis](#)
- [Disconnect a Project Source](#)

## Troubleshooting

### **Test Connection** does not succeed

Verify that the source location and access information are current and that your organization still permits Atloria to access the source. Update the connection information in **Source**, then select **Test Connection** again.

### You cannot find the project to update

Open **Projects** and use **Search projects...** with the project name. If the project still does not appear, confirm that you have access to the correct Atloria workspace or ask an administrator to verify your project permissions.

### **View Source** does not show the expected source

Confirm that you selected the correct project and open **Source** to review its connection information. If the wrong source is connected, update the connection details and select **Test Connection** before using **View Source** again.