Deploy Astro on Northflank

This guide will show you how to get an Astro project built and deployed on Northflank.

To deploy your Astro project on Northflank, you will need to add a Dockerfile to your repository. The simple example below builds the Astro app in the first stage, and then serves the output using the Caddy webserver.

/Dockerfile

FROM node:16 AS build
WORKDIR /app
COPY package.json package.json
COPY yarn.lock yarn.lock
COPY tsconfig.json tsconfig.json
RUN yarn install
COPY src ./src
COPY public ./public
COPY astro.config.mjs astro.config.mjs
RUN yarn build

FROM caddy:latest
COPY --from=build /app/dist /usr/share/caddy
EXPOSE 80

In a new Northflank project, click the 'create new' button at the top of the page and select service. Choose a combined service to both build and deploy your repository. Give your service a sensible name.

Next, in the repository section, select your Astro repository and the branch that you want to build. Choose Dockerfile as the build type, and wait for your Dockerfile to be loaded.

Port 80 will automatically be detected as a public HTTP port and added to your networking configuration. Any other detected ports can be deleted, as they are not required to access your deployed site.

Finally, select an appropriate resource plan and create your service.

Once the service is created, a build will be started automatically. When the build succeeds, a new deployment will be created. You can access your running deployment via the auto generated code.run domain visible on the header in your service dashboard.

The Northflank Astro template repository allows you to quickly deploy the Astro blog starter app.

In a new Northflank project, click the 'create new' button at the top of the page and select service. Click the link at the top of the form to create a service from a template, and select the Astro template. This will create a copy of northflank-guides/deploy-astro-on-northflank in your own VCS account. Select an appropriate resource plan, and create your service.

Once the service is created, a build will be started automatically. When the build succeeds, a new deployment will be created. You can access your running deployment via the auto generated code.run domain visible on the header in your service dashboard.

View the Astro blog starter deployed on Northflank