Skip to content

Your first NAIS application

To run an application on NAIS, a manifest file must be created for it. This file is typically named nais.yaml and in this documentation it is referred to as such. Technically the manifest file can be named anything, but it is recommended to name it nais.yaml.

Not thrilled by the prospect of editing yaml manually?

To kickstart your nais.yaml and GitHub workflow, head over to the app starter or check out our plugins for IntelliJ IDEA or Visual Studio Code

Such a nais.yaml file provides NAIS with the necessary information to run your application. If you are starting out for the first time, the minimal nais.yaml example below is a good starting point.

apiVersion: "nais.io/v1alpha1"
kind: "Application"
metadata:
  name: appname
  namespace: teamname
  labels:
    team: teamname
spec:
  image: europe-north1-docker.pkg.dev/[mgmt-id]/[team-name]/[image-name]:tag

See https://github.com/nais/docker-build-push for more info on how to publish packages to Google Artifact Registry (GAR).

For more information about the nais.yaml specification, see Manifest.

Now that you've created your application, it's time to deploy to Kubernetes.


Last update: 2023-05-15
Created: 2019-09-10