Skip to content
Ownkube

Quickstart

Deploy your first app on Ownkube in minutes. Sign in, connect a source, and get a live URL with automatic TLS, logs and metrics built in. You start with no cloud account or subscription, and there is no cluster to provision.

What you’ll need

Section titled “What you’ll need”
  • A GitHub or GitLab repository Ownkube can build from, or a container image (a public image such as ghcr.io/owner/app:1.2.0)
  • About five minutes

Deploy from the dashboard

Section titled “Deploy from the dashboard”

  1. Sign in

    Go to app.ownkube.io/login and sign in with GitHub or Google. Ownkube creates an organization for you with a Development and a Production environment.

  2. Connect GitHub or GitLab

    Open Settings, go to Version control, and connect the Ownkube GitHub App to the repositories you want to deploy, or connect your GitLab account. Skip this step if you deploy a public container image. See Builds and source.

  3. Create a deployment

    From the dashboard click New (or press ⌘ K and choose Deployment), pick Web app, choose the repository and branch (or the image and tag), set the port your app listens on, and add any variables. Click Create deployment. Every field is covered on Create a deployment.

  4. Get a live URL

    The deployment page shows the build and rollout live. When the status reads Healthy, open the generated *.ownkube.app hostname on the Overview tab. Your app is live with TLS.

Deploy from the terminal

Section titled “Deploy from the terminal”
Terminal window
brew install ownkube/tap/okctl
okctl login
cd my-app
okctl up

okctl up uploads the current directory, builds it, deploys it, and follows the rollout. Run it inside a directory linked with okctl link, or pass --service. See the CLI.

What to do next

Section titled “What to do next”

To add a database, create a Postgres deployment and link it to your app. The connection string lands in your app as a variable.

Open the Logs tab for a live tail, and the Overview tab for CPU, memory and request metrics. See Observability.

To ship the next change, push to the branch. Ownkube rebuilds and rolls out, and it keeps the last revisions for a one-click rollback.

To keep costs down, turn on sleep and wake so an idle app bills nothing, and set a spend limit.

The basics Deployments, environments, projects and the dashboard in one read.
Deploy a framework Framework-specific guides with the right port, build and database steps.