Skip to content
Ownkube

Deploy Laravel

Deploy a Laravel app on Ownkube in minutes. Push your repo and Ownkube builds it and ships it, and you get a live URL with automatic TLS. Managed Postgres, logs, metrics, and one-click rollbacks come built in. No cloud account to start.

What you’ll need

Section titled “What you’ll need”
  • A Laravel app in a GitHub or GitLab repository
  • About five minutes

Deploy it

Section titled “Deploy it”

  1. Connect your repo

    Sign in at app.ownkube.io/login, open Settings, and connect the GitHub App (or GitLab) so Ownkube can reach your repository. Already have a prebuilt image in a registry? Point Ownkube at it instead. See Registries.

  2. Create a Web deployment

    From your dashboard, choose Create deployment, pick Web, and select your Laravel repo. Ownkube builds it and pushes the image to a registry it manages for you.

  3. Set the port

    Laravel apps commonly serve on port 8000. Set that as the port so traffic routes to your app. You can change it later in Settings.

  4. Add environment variables

    Set APP_KEY, APP_ENV=production, APP_DEBUG=false, and your database connection variables. Mark secrets with the Secret toggle. See Environment variables.

  5. Deploy

    Click Create deployment. The deployment page streams the build, then startup and health checks. When the status goes healthy, open the generated hostname on the Overview tab. Your Laravel app is live, with TLS included.

Run migrations

Section titled “Run migrations”

Run php artisan migrate before your app serves traffic. Ownkube’s Jobs resource runs a container to completion, so a migration Job is the right place for artisan migrate rather than running it at request time or on every container start.

Notes for Laravel

Section titled “Notes for Laravel”

Port 8000

Laravel apps commonly serve on port 8000. Set that as the port to match whatever port your app actually listens on.

APP_KEY and production env

Set APP_KEY, APP_ENV=production, and APP_DEBUG=false before your first deploy. Laravel needs APP_KEY to encrypt sessions and cookies.

Migrations as a Job

Run php artisan migrate as a Job before or alongside a deploy, instead of on every container start.

Postgres now, MySQL coming soon

Ownkube’s managed database today is Postgres. Point Laravel’s DB_CONNECTION at pgsql. Managed MySQL is coming soon.

Bring your own Dockerfile

Want full control of the build? Add a Dockerfile to your repo and Ownkube uses it, reading the port from its EXPOSE line.

Add a database

Section titled “Add a database”

Need a database today? Add a managed Postgres Database in one click and Ownkube injects the connection string as DATABASE_URL (plus PGHOST, PGUSER, and friends) into your app. Set DB_CONNECTION=pgsql and map the pieces into Laravel’s database config. See Databases.

Scale and observe

Section titled “Scale and observe”

Once you’re running, turn on autoscaling on CPU and memory, watch logs and metrics on every deployment, and roll back a bad deploy in one click.

Scheduled jobs Run migrations and other one-off tasks to completion.
Environment variables Set config and secrets, including APP_KEY.