# Manual installation

Learn the steps to manually integrate Croct into your Laravel project.

The following guide gives you a step-by-step overview of how to install and configure the package in your project.

> **Speed up your integration!**
>
> The CLI can fully automate the integration process for you. Check out the [integration guide](/reference/sdk/laravel/integration) to get started faster.

## Install the package \[#install]

Install the package using [Composer](https://getcomposer.org):

```sh
composer require croct/plug-laravel
```

Laravel [auto-discovers](https://laravel.com/docs/packages#package-discovery) the service provider, so there is nothing to register. This also pulls in a [PSR-18 HTTP client](https://www.php-fig.org/psr/psr-18/) and PSR-7 factories, so there is nothing else to install.

## Configure your credentials \[#configure]

Add your application ID and API key to the `.env` file in your project root:

**.env**

```bash
CROCT_APP_ID=<APPLICATION_ID>
CROCT_API_KEY=<API_KEY>
```

You can find the application ID and create an API key on the [Integration page](https://app.croct.com/redirect/organizations/-organization-/workspaces/-workspace-/applications/-application-/integration) of your application.

## Customize the configuration \[#customize]

The package works out of the box with sensible defaults. To customize any option, publish the configuration file:

```sh
php artisan vendor:publish --tag=croct-config
```

This creates `config/croct.php`, where you can adjust locale detection, cookies, and script injection. For all available options, see [Configuration](/reference/sdk/laravel/api/configuration).

## Check your integration \[#check]

If you open your application now, it should start sending events.

To check if your integration is working, go to the [Integration page](https://app.croct.com/redirect/organizations/-organization-/workspaces/-workspace-/applications/-application-/integration) of your application.

![Integration status](/assets/reference/sdk/integration-status.png)

When working correctly, you should see a green bullet next to the **Status** label saying **"Received traffic in the past 24 hours"**. If you still do not see this message after a few minutes, see the [Troubleshooting](troubleshooting) reference.

## Explore

- [CLI](/reference/sdk/laravel/integration): Learn how to use our CLI to get started faster.
- [Troubleshooting](/reference/sdk/laravel/troubleshooting): Identify and resolve issues with your integration.