Skip to main content

Values Reference

Artifact Hub

Complete default values.yaml Reference​

Below is the complete values.yaml file with all available configuration options and their default values:

values.yaml
# A list of containers that should run the pods of this component
containers: []

# Defines a rolling update strategy for the component
rollingUpdate:
  enabled: true

# Defines a list of init containers for the component
initContainers: []

# Defines a number of replicas for the component
replicas: 1

# Defines a service for the component
service:
  type: ClusterIP
  labels: {}
  annotations: {}
  ports: []
  externalIPs: []

# Labels for the component
labels: {}

# Annotations for the component
annotations: {}

# Ingress for the component
ingress:
  disabled: false
  labels: {}
  annotations: {}
  certmanager: true
  rules: []

# Persistent volumes for the component
# Then mount them in containers above
volumes: []

# Defines image pull secrets
# DevSpace CLI will append all pull secrets which are automatically created
# More infos on: https://devspace.cloud/docs/cli/image-building/workflow-basics#8-create-image-pull-secret
pullSecrets: []

# Service account for the component
serviceaccount: {}

# Config map for the component
configmap: {}

# Secret for the component
secrets: {}

# HTTP routes for the gateway API ingress of the component
httpRoutes: []
  # - name: my-http-route
  #   apiVersion: gateway.networking.k8s.io/v1
  #   labels: {}
  #   annotations: {}
  #   spec:
  #     parentRefs:
  #       - name: my-gateway
  #     hostnames:
  #       - example.com
  #     rules:
  #       - matches:
  #           - path:
  #               type: PathPrefix
  #               value: /
  #         backendRefs:
  #           - name: my-service
  #             port: 80


# External secrets for the component
externalSecrets: []
  # - name: my-external-secret
  #   annotations: {}
  #   refreshInterval: "0s"  # Set to "0s" to disable auto-refresh, or "1h", "5m", etc.
  #   secretStoreRef:
  #     name: my-secret-store
  #     kind: SecretStore
  #   target:
  #     name: my-external-secret
  #     creationPolicy: Owner
  #   data:
  #     - secretKey: MY_SECRET_KEY
  #       remoteRef:
  #         key: /path/to/parameter

# Extra objects for the component
extraObjects: []

Configuration Sections​

The values.yaml is organized into the following main sections:

Core Configuration​

  • containers - Define application containers with images, env vars, and resources
  • initContainers - Initialize containers that run before main containers
  • replicas - Number of pod replicas (default: 1)
  • rollingUpdate - Rolling update strategy configuration

Networking​

  • service - Kubernetes Service configuration for internal networking
  • ingress - Ingress configuration for external traffic with TLS support

Storage​

  • volumes - Persistent volume claims and volume definitions

Security & Access​

  • pullSecrets - Image registry authentication secrets
  • serviceaccount - Kubernetes ServiceAccount configuration
  • secrets - Kubernetes Secret creation (ArgoCD Vault Plugin compatible)
  • configmap - ConfigMap for non-sensitive configuration
  • externalSecrets - External Secrets Operator integration

Metadata​

  • labels - Additional Kubernetes labels for all resources
  • annotations - Additional Kubernetes annotations for all resources

Advanced​

  • autoScaling - Horizontal Pod Autoscaler configuration
  • extraObjects - Raw Kubernetes objects (CRDs, KEDA, etc.)

Example Usage​

# Simple web application
containers:
  - name: web
    image: nginx
    imageTag: "1.21"

service:
  ports:
    - port: 80

ingress:
  rules:
    - host: myapp.example.com
  tls: true

See Also​