- Laravel
- Symfony
- Next.js
- Nuxt
- Node.js
- Go
- Python
- Ruby and Rails
Prerequisites
- A supported PHP version
- Laravel 9.x or greater
- A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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.
4
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.
5
Set build and deploy commands
Set your build command to install dependencies and compile assets:Set your deploy command to run database migrations on each deployment:
composer install --no-dev && npm run build
php artisan migrate --force
6
Add environment variables
At minimum, set your If your application uses a database, connect a MySQL or Postgres resource from the infrastructure canvas; Laravel Cloud will automatically inject the connection environment variables.
APP_KEY. You can generate one locally and paste the value into the Laravel Cloud dashboard:php artisan key:generate --show
7
Deploy
Click the Deploy button. Laravel Cloud will build your application, run your deploy command, and route traffic to the new instance.
Prerequisites
- A supported PHP version
- Symfony 7.4 LTS or 8.x
- A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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.
php bin/console as the command runner.4
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.
5
Set build and deploy commands
Set your build command to install dependencies and compile assets:Set your deploy command to run database migrations on each deployment:
composer install --no-dev && php bin/console asset-map:compile
php bin/console doctrine:migrations:migrate --no-interaction
6
Add environment variables
At minimum, set
If your application uses a database, connect a MySQL or Postgres resource from the infrastructure canvas; Laravel Cloud will automatically inject the
APP_ENV and APP_SECRET in the Laravel Cloud dashboard:| Variable | Value |
|---|---|
APP_ENV | prod |
APP_SECRET | A securely generated secret string |
DATABASE_URL environment variable.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.7
Deploy
Click the Deploy button. Laravel Cloud will build your application, run your deploy command, and route traffic to the new instance.
Prerequisites
- A supported Node.js, Bun, or Deno version
- A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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. You can also choose the Port to serve on. Then, click Create Application.
4
Adjust the Node.js version
In your environment settings, set the Node version to the appropriate one your application requires.
5
Set the build command
Set your build command to install dependencies and compile your application:Laravel Cloud sets a sensible default start command for Next.js applications, running the
npm ci --audit false
npm run build
start script defined in your package.json (or the deno task start command, if you’re using the Deno runtime). You can override it from your deployment settings if needed.6
Add environment variables
Add any environment variables your application requires in the Laravel Cloud dashboard. Variables prefixed with
NEXT_PUBLIC_ are available in the browser; all other variables are server-only.Laravel Cloud automatically sets NODE_ENV=production and NEXT_PUBLIC_SITE_URL (your application’s URL) on every deployment. If your application uses a database or cache, connect a resource from the infrastructure canvas; Laravel Cloud will automatically inject the DATABASE_URL or REDIS_URL connection string.7
Deploy
Click the Deploy button. Laravel Cloud will build your application and route traffic to the new instance.
Prerequisites
- A supported Node.js, Bun, or Deno version
- A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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. You can also choose the Mode (server or static site generation) and the Port to serve on. Then, click Create Application.
4
Adjust the Node.js version
In your environment settings, set the Node version to the appropriate one your application requires.
5
Set the build command
Set your build command to install dependencies and compile your application:Laravel Cloud sets a sensible default start command for Nuxt applications, running
npm ci --audit false
npm run build
# alternatively for static site generation
# npx nuxt generate
.output/server/index.mjs with node, bun run, or deno run -A depending on your runtime. You can override it from your deployment settings if needed.Laravel Cloud runs Nitro’s default
node-server preset, which outputs to .output/server/index.mjs. If your nuxt.config was previously deployed to another host, remove any nitro.preset option (for example, vercel, netlify, or cloudflare) and any NITRO_PRESET environment variable. A leftover preset still builds successfully, but it produces output Laravel Cloud can’t serve, and your deployment will complete without routing any traffic to your application.6
Add environment variables
Add any environment variables your application requires in the Laravel Cloud dashboard. Variables prefixed with
NUXT_PUBLIC_ are available client-side; all other variables are server-only.Laravel Cloud automatically sets NODE_ENV=production and NUXT_PUBLIC_SITE_URL (your application’s URL) on every deployment. If your application uses a database or cache, connect a resource from the infrastructure canvas; Laravel Cloud will automatically inject the DATABASE_URL or REDIS_URL connection string.7
Deploy
Click the Deploy button. Laravel Cloud will build your application and route traffic to the new instance.
Prerequisites
- A supported Node.js, Bun, or Deno version
- An Express, Hono, or other Node.js application with a
package.jsonfile at the root of your repository - A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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. You can also choose the Port to serve on from the Advanced settings. Then, click Create Application.
package.json file. Applications that don’t use a recognized framework are still supported as generic Node.js applications.4
Adjust the Node.js version
In your environment settings, set the Node version to the appropriate one your application requires.
5
Set the build and start commands
Laravel Cloud pre-fills your build command to install your application’s dependencies:If your application has a compilation step, such as a TypeScript build, append
npm ci --audit false
npm run build to your build command.Laravel Cloud also pre-fills a start command based on the start script or main entry in your package.json file, such as node server.js. When neither can be resolved to a file, the start command falls back to npm start (or bun run start / deno task start, depending on your runtime). You can override it from your deployment settings if needed.6
Add environment variables
Add any environment variables your application requires in the Laravel Cloud dashboard. Laravel Cloud sets these variables on your application process rather than writing a
.env file, so read them from process.env; your application doesn’t need a loader such as dotenv.Laravel Cloud automatically sets NODE_ENV=production and APP_URL (your application’s URL) on every deployment. If your application uses a database or cache, connect a resource from the infrastructure canvas; Laravel Cloud will automatically inject the DATABASE_URL or REDIS_URL connection string.Your application must listen on the port Laravel Cloud provides via the PORT environment variable (3000 by default):app.listen(process.env.PORT || 3000);
7
Deploy
Click the Deploy button. Laravel Cloud will build your application and route traffic to the new instance.
Prerequisites
- A supported Go version
- A
go.modfile at the root of your repository - A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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.
go.mod file and reads your Go version from the go directive at the top of that file.4
Set the build command
Cloud pre-fills your build command for the detected entrypoint. An application with its Cloud adjusts the package path for entrypoints such as
main package at the repository root and no detected cgo requirements uses:CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o app .
cmd/server and sets CGO_ENABLED=1 when it detects cgo requirements. The default start command, ./app, runs the resulting binary. If you change the output path or binary name, update the start command to match.5
Add environment variables
Add any environment variables your application requires in the Laravel Cloud dashboard. If your application uses a database or cache, connect a resource from the infrastructure canvas; Laravel Cloud will automatically inject the
DATABASE_URL or REDIS_URL connection string.Cloud supplies these variables through the process environment. Read them with os.Getenv.Your application must listen on the port Laravel Cloud provides via the PORT environment variable (3000 by default).6
Deploy
Click the Deploy button. Laravel Cloud will build your application and route traffic to the new instance.
Prerequisites
- A supported Python version
- A
pyproject.toml,requirements.txt,Pipfile, orsetup.pyfile - A GitHub, GitLab, or Bitbucket account
1
Go to your main Laravel Cloud dashboard page and select + New application.
2
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.
3
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.
4
Set the build command (optional)
Cloud installs your dependencies automatically during the build, using your lockfile or dependency manifest. It pre-fills additional steps when needed, such as installing a missing application server or collecting Django static files. You may edit these commands or add your own steps:
python manage.py collectstatic --noinput
5
Set the start command
Cloud pre-fills a start command using your detected framework, entrypoint, and a compatible server from your dependencies. Django and Flask default to Gunicorn; FastAPI defaults to Uvicorn. If you need to set the command yourself, these examples use the default servers:
| Framework | Example start command |
|---|---|
| Django | gunicorn <project>.wsgi --bind [::]:$PORT |
| FastAPI | uvicorn main:app --host :: --port $PORT |
| Flask | gunicorn app:app --bind [::]:$PORT |
| Generic Python | python main.py |
Replace the example entrypoint with your application’s module or callable. If your Django start command still contains
<project>, Cloud requires you to replace it before deploying. Keep the server in your dependencies to control its version. For Uvicorn, use --host :: even if the pre-filled command uses --host ''; see the Python deploy guide.6
Add environment variables
Add any environment variables your application requires in the Laravel Cloud dashboard. If your application uses a database or cache, connect a resource from the infrastructure canvas; Laravel Cloud will automatically inject the
DATABASE_URL or REDIS_URL connection string.Cloud supplies these variables through the process environment. Read them from os.environ. For Django, configure the environment and proxy settings before deploying.7
Deploy
Click the Deploy button. Laravel Cloud will build your application and route traffic to the new instance.
Prerequisites
- A supported Ruby version
- A committed
GemfileandGemfile.lockin your application directory - A GitHub, GitLab, or Bitbucket account
1
Create an application
From your Laravel Cloud dashboard, select New application, connect your Git provider, and choose your repository and deployment region. For a monorepo, select the directory containing your
Gemfile.Laravel Cloud detects Ruby applications and recognizes Rails from its application configuration and framework files. If the repository scan reports a missing lockfile platform, run bundle lock --add-platform aarch64-linux locally, commit the lockfile, and refresh the scan.2
Review the Ruby version
Declare your version in
.ruby-version, or review the other supported version declarations. When your repository does not declare a version, you may choose one in your environment’s General Settings.3
Review build and start commands
Laravel Cloud installs gems automatically using your lockfile. For Rails applications with detected assets, it pre-fills asset compilation and any detected JavaScript dependency installation:The default Rails start command uses your binstub when available:Laravel Cloud uses a Procfile
SECRET_KEY_BASE_DUMMY=1 bundle exec rails assets:precompile
bundle exec bin/rails server -b '::' -p $PORT
web command when one exists. Keep your server in the foreground, listening on PORT and accepting IPv6 connections. See the Ruby and Rails deploy guide for Puma, Rack, and generic Ruby commands.4
Configure Rails secrets and resources
New Rails environments include a generated
SECRET_KEY_BASE. Preserve your existing value when migrating an application, and add RAILS_MASTER_KEY if production uses encrypted credentials.Connect a Postgres or MySQL database from the infrastructure canvas and include its pg or mysql2 adapter in your production bundle. Laravel Cloud supplies DATABASE_URL. Review any separate Solid Cache, Solid Queue, or Solid Cable connections before attaching the database.5
Review the deploy command
For Rails applications using a database, set your deploy command to:Attaching a database enables this command if you have kept the default deploy command. Add it yourself if you have customized that command.
bin/rails db:prepare
6
Deploy
Click Deploy. Laravel Cloud builds your application, runs the deploy command, and routes traffic to the new deployment. Configure any job workers as background processes.