Ryvn provides native support for deploying applications using Helm charts, giving you complete control over your Kubernetes resources while maintaining the simplicity of Ryvn’s deployment workflow.

​
Prerequisites

​
Kubernetes Resource Support

Ryvn supports all Kubernetes resource types that can be defined in your Helm chart. This includes commonly used resources like ConfigMaps, Secrets, Persistent Volumes, and Service Accounts, as well as any Custom Resource Definitions (CRDs) your application requires.

​
Create Your Service

1

Chart Requirements

Your Helm chart should follow these requirements:
  • Use specific chart versions (avoid latest or floating versions)
  • Define proper Kubernetes resources
  • Include valid health check endpoints
  • Use values.yaml for configuration
2

Create Service

Open the Ryvn Dashboard, go to the Services tab, and click Create Service in the top-right corner. Choose Chart as your service type.
3

Configure Chart

Give your service a name and provide your chart details: - Repository URL - Chart name - Registry credentials (if private)
4

Setup GitHub Actions (Optional)

After creating your service, you’ll have the option to set up GitHub Actions for automated deployments. Click Setup GitHub Actions to create a workflow that automatically builds and deploys your Helm chart when you push changes.See GitHub Actions Integration for detailed setup instructions.
We support pulling charts from public repositories, GitHub repositories, and private OCI registries. For other private chart repositories, please contact us.

​
Private Registry Support

Ryvn supports deploying Helm charts from private OCI registries. To use a private registry:
1

Add Registry Credentials

First, add your registry credentials through Settings in the Ryvn Dashboard:
  1. Navigate to Settings
  2. Select the Registries tab
  3. Click “Add Registry”
  4. Enter your registry name, URL, and authentication credentials
2

Select Registry for Chart

When creating your Chart service:
  1. Select the registry you added from the dropdown
  2. Specify the repository path within the registry where your Helm chart is stored
Ryvn will automatically authenticate with your private registry during deployment and pull the specified Helm chart.

​
Deploy to Environment

1

Navigate to Environment

Go to the Environments tab in the Ryvn Dashboard and select the environment where you want to deploy your Helm chart.
2

Start Installation

Click Add Service and select your Helm chart service from the list.
3

Configure Values

Configure your chart’s values for this installation
Values specified here will override the defaults in your chart’s values.yaml.
4

Set Environment Variables

Define any environment variables needed for your deployment
5

Deploy

Click Create Installation. Ryvn will begin pulling your chart and creating the necessary resources in your environment.
Once deployed, you can monitor your installation’s status directly from the dashboard. View the Helm release status, check resource health, and access logs to ensure everything is running as expected.

​
Automated Deployments with GitHub Actions

For Helm chart services, you can set up automated deployments using GitHub Actions. This integration enables:
  • Automatic builds and deployments when you push changes to your chart
  • Version management through Git tags
  • Synchronized releases between GitHub and Ryvn
  • Controlled deployments through release channels
You can set up GitHub Actions:
  • During service creation (recommended)
  • Later through the service’s menu options
For complete setup instructions and workflow details, see our GitHub Actions Integration guide.

​
Release Management

Ryvn integrates with your existing release workflow: