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

# Quickstart

> Get started with Laravel Cloud and deploy your first application in minutes.

Select your framework to get started:

<Tabs>
  <Tab title="Laravel">
    ## Prerequisites

    * PHP 8.2 or greater
    * Laravel 9.x or greater
    * A GitHub, GitLab, or Bitbucket account

    <Steps>
      <Step title="Go to your main Laravel Cloud dashboard page and select + New application.">
        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/get-started.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=9ca25f5a415e758e421ab3119ad3fd3a" width="1920" height="1080" data-path="images/get-started.png" />
        </Frame>
      </Step>

      <Step title="Connect your Git provider">
        Select Connect to GitHub (or GitLab or Bitbucket). A new tab / window will open. Sign in to your Git provider and select the user / organization and repositories you want to give Laravel Cloud access to.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/connect-github.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=7ee33f2b2987e77f4304b41b1c2e1cf4" width="1920" height="1080" data-path="images/connect-github.png" />
        </Frame>

        After completing the Git provider authentication flow, you will be redirected back to Laravel Cloud.
      </Step>

      <Step title="Create a new application">
        Select the repository you want to use, name your Laravel Cloud application, and select a Region where your application will deploy. Then, click Create Application.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/create-your-application.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=642c5d79e9ef91ac94e6abd0ff14faaf" width="1920" height="1080" data-path="images/create-your-application.png" />
        </Frame>

        Your application will be created along with a default environment. You will then be redirected to your application's default environment overview page.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/application-canvas.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=341661f5355a4a8dba269b495636ca56" width="3024" height="1898" data-path="images/application-canvas.png" />
        </Frame>
      </Step>

      <Step title="Select the PHP runtime">
        In your environment settings, confirm the runtime is set to **PHP** and select the PHP version that matches your application's requirements.
      </Step>

      <Step title="Set build and deploy commands">
        Set your **build command** to install dependencies and compile assets:

        ```sh theme={null}
        composer install --no-dev && npm run build
        ```

        Set your **deploy command** to run database migrations on each deployment:

        ```sh theme={null}
        php artisan migrate --force
        ```
      </Step>

      <Step title="Add environment variables">
        At minimum, set your `APP_KEY`. You can generate one locally and paste the value into the Laravel Cloud dashboard:

        ```sh theme={null}
        php artisan key:generate --show
        ```

        If your application uses a database, connect a [MySQL](/resources/databases/laravel-mysql) or [Postgres](/resources/databases/postgres) resource from the infrastructure canvas; Laravel Cloud will automatically inject the connection environment variables.
      </Step>

      <Step title="Deploy">
        Click the **Deploy** button. Laravel Cloud will build your application, run your deploy command, and route traffic to the new instance.
      </Step>
    </Steps>

    Congratulations! Your Laravel application is live on Laravel Cloud! Continue reading to learn about [environments](/environments), [databases](/resources/databases/laravel-mysql), [managed queues](/queues), and [more](/organizations).
  </Tab>

  <Tab title="Symfony">
    ## Prerequisites

    * PHP 8.2 or greater
    * Symfony 7.4 LTS or 8.x
    * A GitHub, GitLab, or Bitbucket account

    <Steps>
      <Step title="Go to your main Laravel Cloud dashboard page and select + New application.">
        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/get-started.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=9ca25f5a415e758e421ab3119ad3fd3a" width="1920" height="1080" data-path="images/get-started.png" />
        </Frame>
      </Step>

      <Step title="Connect your Git provider">
        Select Continue with GitHub, GitLab, or Bitbucket. A new tab / window will open. Sign in to your Git provider and select the user / organization and repositories you want to give Laravel Cloud access to.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/connect-github.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=7ee33f2b2987e77f4304b41b1c2e1cf4" width="1920" height="1080" data-path="images/connect-github.png" />
        </Frame>

        After completing the Git provider authentication flow, you will be redirected back to Laravel Cloud.
      </Step>

      <Step title="Create a new application">
        Select the repository you want to use, name your Laravel Cloud application, and select a Region where your application will deploy. Then, click Create Application.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/create-your-application.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=642c5d79e9ef91ac94e6abd0ff14faaf" width="1920" height="1080" data-path="images/create-your-application.png" />
        </Frame>

        Your application will be created along with a default environment. You will then be redirected to your application's default environment overview page.

        <Frame>
          <img src="https://mintcdn.com/cloud/8pAFT9XqgdEZfyyx/images/application-canvas.png?fit=max&auto=format&n=8pAFT9XqgdEZfyyx&q=85&s=341661f5355a4a8dba269b495636ca56" width="3024" height="1898" data-path="images/application-canvas.png" />
        </Frame>

        Laravel Cloud automatically detects Symfony applications and configures `php bin/console` as the command runner.
      </Step>

      <Step title="Select the PHP runtime">
        In your environment settings, confirm the runtime is set to **PHP** and select the PHP version that matches your application's requirements.
      </Step>

      <Step title="Set build and deploy commands">
        Set your **build command** to install dependencies and compile assets:

        ```sh theme={null}
        composer install --no-dev && php bin/console asset-map:compile
        ```

        Set your **deploy command** to run database migrations on each deployment:

        ```sh theme={null}
        php bin/console doctrine:migrations:migrate --no-interaction
        ```
      </Step>

      <Step title="Add environment variables">
        At minimum, set `APP_ENV` and `APP_SECRET` in the Laravel Cloud dashboard:

        | Variable     | Value                              |
        | ------------ | ---------------------------------- |
        | `APP_ENV`    | `prod`                             |
        | `APP_SECRET` | A securely generated secret string |

        If your application uses a database, connect a [MySQL](/resources/databases/laravel-mysql) or [Postgres](/resources/databases/postgres) resource from the infrastructure canvas; Laravel Cloud will automatically inject the `DATABASE_URL` environment variable.

        <Note>If your application defines `DATABASE_URL` or other Cloud-injected variables in `.env.prod`, those values will take precedence over Cloud's runtime injection. Keep Cloud-managed variables out of `.env.prod` to avoid unexpected overrides.</Note>
      </Step>

      <Step title="Deploy">
        Click the **Deploy** button. Laravel Cloud will build your application, run your deploy command, and route traffic to the new instance.
      </Step>
    </Steps>

    Congratulations! Your Symfony application is live on Laravel Cloud! Continue reading to learn about [environments](/environments), [databases](/resources/databases/laravel-mysql), [managed queues](/queues), and [more](/organizations).
  </Tab>
</Tabs>