Skip to content
Ownkube

Deploy Astro

Deploy an Astro site 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”
  • An Astro site in a GitHub or GitLab repository
  • About five minutes

Fully static sites

If your site has no server-rendered routes, you don’t need a server process at all. Keep output: 'static' and Ownkube deploys it as a static build, no port to configure.

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 Astro repo. Ownkube builds it and pushes the image to a registry it manages for you.

  3. Set the port

    For server-rendered routes, add the Node adapter (@astrojs/node) and set the port to 4321, its default, with HOST=0.0.0.0 so it’s reachable. Fully static sites (output: 'static') skip this step entirely, there’s no port to configure. You can change it later in Settings.

  4. Add environment variables

    Add any KEY=value pairs your app reads, and 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 Astro site is live, with TLS included.

Notes for Astro

Section titled “Notes for Astro”

SSR vs static

Add the Node adapter (@astrojs/node) for server-rendered routes, or leave output: 'static' for a fully static build.

Port 4321, HOST=0.0.0.0

The Node adapter’s standalone server listens on 4321 and honors HOST/PORT. Set HOST=0.0.0.0 so it’s reachable, and set 4321 as the port in Ownkube.

Static output option

A pure static build has no server to keep alive and no port to configure, it just serves files.

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 Postgres? Add a Database in one click and Ownkube injects the connection string as DATABASE_URL (plus PGHOST, PGUSER, and friends) into your app. 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.

Quickstart The full signup-to-live-app path, any stack.
Autoscaling Scale server-rendered Astro routes on demand.