Skip to content
Configuration

Configuration

np.yaml Reference

# np.yaml — complete reference

# Service name (required)
name: my-service

# Binary to deploy (optional, for native binaries)
binary: ./my-server

# Docker image (optional, for container workloads)
image: my-service:latest

# Health check endpoint (optional)
health_check: /health

# Resource limits
resources:
  cpu: 200m       # CPU shares (Kubernetes-style)
  memory: 128mb   # Memory limit

# Scaling
count: 3          # Number of replicas

# Environment variables
env:
  DATABASE_URL: "postgres://localhost:5432/db"
  LOG_LEVEL: info

# Ports
ports:
  - 8080          # HTTP
  - 9090          # Metrics

# Update strategy
update:
  max_parallel: 1     # How many to update at once
  min_healthy_time: 10s
  healthy_deadline: 2m
  auto_revert: true

Minimal Example

name: hello
binary: ./hello-server
health_check: /health

Full Example

name: api
binary: ./api-server
health_check: /healthz
resources:
  cpu: 500m
  memory: 256mb
count: 3
env:
  ENV: production
  PORT: "8080"
ports:
  - 8080
update:
  max_parallel: 2
  min_healthy_time: 30s
  auto_revert: true

Next: Commands reference →