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

# How to Deploy Laravel Applications with ORIV?

> Learn how to deploy your Laravel application on ORIV in minutes. A simple, complete guide for setup, Git integration, and database management.

Deploying [**Laravel applications**](https://oriv.cloud/laravel-hosting/) can often involve multiple steps and intricate configurations. ORIV simplifies this process by providing a streamlined platform tailored for deploying modern PHP applications, including Laravel, with minimal complexity. This tutorial provides a comprehensive, step-by-step guide to help you deploy your Laravel application using ORIV. If you are launching a new project or migrating an existing one, you’ll learn how to set up your server, configure your Git repository, manage your database, and finalize your deployment—all within the ORIV environment.

Follow this step-by-step guide to configure and deploy your fully functional Laravel website with ease.

## **Step 1: Choose Your Server**

Log in to your [**ORIV dashboard**](https://app.oriv.cloud/)and click the **‘+New Site’** to add a new site. Then, choose a server from the list and go to ‘**Next’**.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 2: Go to The Laravel Tab**

From here go to the **‘Laravel’ tab** to deploy your Laravel applications. Now, choose **‘Clone A Git Repository’** to import your custom PHP site.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 3: Set Up Domains**

From the **‘Domains’** tab, you will get two options: either you can create a **‘Demo Site’** with a test domain and refine it until it is ready for launch, or, you can migrate into a new domain to get your site up and running in a new domain.

Or you can create your site with your live domain; you need to select the **‘Migrate into a New Domain’** option. Then you have to pu**t ‘New Site Title’** and **‘Domain Name’**. Here we are choosing **the ‘Demo Site’** domain. Then click on **‘Next’**.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 4: Settings To Manage Database**

Now, you will be sent to the **‘Settings’** step. Make sure to correctly add your **‘PHP Version’**, **‘Site User’**, **‘Web root’**.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

Now, it is time for database management. You will get three options. You can either create a new database on the server, you can add your existing database that is hosted on another server.

 You can also proceed without any database. For this tutorial, we are going with the **‘Create Database In Server’** option.

If you select this option, enter your **‘Database Name’**, **‘Database Username’ and ‘Database Password’.** You can keep these auto-generated credentials, or you can modify them according to your choice.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

After selecting any one option and providing all essential information and credentials, click on **‘Next’.**

## **Step 5: Insert Git Repository Credentials**

In the **‘Git Repo’** tab, add your **‘Git Repository’** and ‘**Git Branch’**. Also, toggle on the **‘Enable push to deploy’** option. Once you enable the **‘Push To Deploy’**, it will generate a **‘Deployment**

**URL’**. We can use this URL to CICD pipeline and copy the **‘Deployment URL’** from here.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 6: Add the Deployment URL to the Git Repository**

Now, go to your Git repository. From the **‘Code‘** tab, go to the **‘Settings’** tab and click on the **‘Webhooks’** page from the ‘**Code and automation’** section of the left navigation. Insert the deployment URL into the **‘Payload URL’** field. Select **‘application/json’** from the **‘Content type’** dropdown.

*Note: This step is optional. Adding a webhook enables automatic deployments when you push changes to the repository, but it’s not required if you prefer to deploy manually.*

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 7: Add Public Key to Git Repository**

Next in the ‘Deploy Script’ field any script that needs to be executed after the site is deployed. For example, you can use it to install dependencies or run database migrations.

**Next, in the ‘Deploy Script’ field, specify any commands that need to be executed after the site is deployed.** If your project uses **PHP**, you can specify the version (e.g., php8.1) and run Composer along with Laravel-specific commands like this:

```
php8.1 $(which composer) install --no-interaction --prefer-dist --optimize-autoloader --no-dev
```

```
php8.1 artisan migrate --force
```

```
php8.1 artisan optimize:clear
```

If your project also involves **Node.js**, you can include additional commands as well. These scripts ensure that your backend and frontend are fully prepared after deployment.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

From the ORIV dashboard, copy the **‘Public Key’** to add it to your Git repository as a deploy key. Git migration uses the **‘Public Key’** for SSH authentication. This is necessary to enable ORIV to access your Git repository and clone it. It ensures secure and authorized access for the cloning process.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

Now, again, go to your Git Repository. From the **‘Code‘** tab, go to the **‘Settings’** tab and click on **‘Deploy keys’** in the security section of the left navigation. Click on the **‘Add key’** button and paste the key that you copied from ORIV.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

After inserting the deploy key in GitHub, click on **‘Next’** on your ORIV settings of the **‘Git Repo’** tab.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

## **Step 8: Confirm Migrating The Website**

Now, to start the migration process, click on the **‘Start’** button. After clicking on the **‘Start’** button, the migration process will start and you will see the progress of migration.

Once the migration is successfully complete will see the following screen. You go to the site dashboard from there. Go to the **‘Laravel’** Option from the menu and customize the **‘Application’** and **‘Environment’** as your preferences.

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

Check out the other features of Laravel:

[***How to Use Supervisor for Process Management With ORIV***](https://oriv.cloud/docs/supervisor-for-process-management/)

[***How to Set Up Laravel Horizon with ORIV***](https://oriv.cloud/docs/set-up-laravel-horizon/)

[***How to Set Up a Queue Worker for Laravel Applications***](https://oriv.cloud/docs/set-up-queue-worker-for-laravel-applications/)

Configure Laravel Scheduler with cron job for your Laravel projects with ease. Check out this documentation for more details:\
[***How To Configure ORIV Cron Job?***](https://oriv.cloud/docs/how-to-configure-oriv-cron-job/)

> \[!NOTE]
> Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em **[support@oriv.cloud](mailto:support@oriv.cloud)**.

And that’s it. This is how easily you can successfully deploy your Laravel application on ORIV. Now you can go to your site dashboard from ORIV and customize according to your preferences.

If you are still stuck, feel free to contact our **[support team](https://oriv.cloud/support).**