Laravel Cloud

LaraCopilot integrates with Laravel Cloud to let you deploy any project to production without leaving the platform. Connect your Laravel Cloud account once, then deploy any project with a single click.

---

Connecting your Laravel Cloud account

Before you can deploy, you need to connect a Laravel Cloud API token.

Step 1 — Get your API token from Laravel Cloud

1. Go to cloud.laravel.com and sign in
2. Open Organization Settings → API Tokens
3. Click Create Token, give it a name and expiry date
4. Copy the token immediately — it won't be shown again

Step 2 — Connect GitHub to Laravel Cloud

Laravel Cloud requires your GitHub account to be connected for deployments:

1. In Laravel Cloud, go to Profile → Account → Source Control
2. Click Connect next to GitHub and authorize the Laravel Cloud GitHub app

Step 3 — Add your token to LaraCopilot

1. In LaraCopilot, go to Settings → Laravel Cloud (or the Laravel Cloud page in the sidebar)
2. Paste your API token in the input field
3. Click Connect

Once connected, you'll see your organization name and a "Connected" badge. The Laravel Cloud button will become active in the IDE.

---

Deploying a project

1. Open your project in the IDE
2. Click Laravel Cloud in the header toolbar
3. LaraCopilot starts the deployment and shows a progress modal
4. Once the deployment finishes, a cloud URL is shown
5. Click the URL to open your live production app

---

Managing deployed applications

Go to Laravel Cloud in the sidebar to see all applications deployed from LaraCopilot.

Each deployed app shows:

---

Redeploying

After making changes to your project, click Redeploy on the Laravel Cloud page to push the latest code and trigger a new build. The button shows a spinner during deployment and turns green on success.

---

Deployment logs

Click History on any deployed app, then click View Logs on any deployment entry to open a full log view. Logs are organised by stage:

• Preparing
• Building
• Pushing
• Deploying

Each stage can be expanded to see the raw build output.

---

Custom domains

You can add a custom domain to any deployed Laravel Cloud application.

Adding a domain

1. Click Custom Domain next to the app
2. Copy the Cloud URL shown (this is your CNAME target)
3. In your DNS provider, add a CNAME record:
   • Type: CNAME
   • Name: your subdomain (e.g. app)
   • Value: the Cloud URL you copied
4. Back in LaraCopilot, enter your full domain (e.g. app.yourdomain.com)
5. Click Add Domain

Verifying your domain

DNS changes can take up to 24 hours to propagate. LaraCopilot automatically checks verification every 15 minutes. You can also click Check Verification to trigger an immediate check.

Once verified, the domain status changes to Active & Verified.

Updating or removing a domain

• Click Custom Domain → Update to change the domain name
• Click Delete to remove the custom domain (the app remains accessible via the default cloud URL)

---

Updating your token

If your Laravel Cloud token expires or you want to replace it:

1. Go to Settings → Laravel Cloud
2. Click Replace Token
3. Paste the new token and click Save New Token

---

Disconnecting Laravel Cloud

1. Go to Settings → Laravel Cloud
2. Click Disconnect
3. The token is removed — the Laravel Cloud button in the IDE will be disabled until you reconnect

Existing deployments in Laravel Cloud are not affected by disconnecting.