Deploy applications directly from your GitHub repository. Ryvn automatically detects your application type and builds a container using buildpacks, storing it in our secure Ryvn Registry.

​
Prerequisites

Before you begin, ensure you have:

  • A GitHub repository with your application code
  • Environment provisioned in AWS, Google Cloud, or Azure

​
Create Your Service

1

Open Dashboard

Open the Ryvn Dashboard and go to the Services tab

2

Start Creation

Click Create Service in the top-right corner
3

Choose Service Type

Select your service type:

TypeDescription
ServerLong-running service that handles HTTP/HTTPS traffic
WorkerLong-running service for background processing
JobShort-lived task that runs to completion
TerraformInfrastructure as code service for managing cloud resources
ChartCustom Kubernetes workloads via Helm charts
4

Select Repository

Choose GitHub and select your repository from the dropdown
5

Configure Build

Select the branch to deploy from (defaults to main)

For Terraform services, you can optionally specify a path to the directory containing your Terraform configuration if it’s not in the repository root.

6

Create

Click Create

7

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 application when you push changes.

See GitHub Actions Integration for detailed setup instructions.

​
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 application.

2

Create Installation

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

Configure Installation

Review and adjust your installation settings: - Resource allocation - Port configuration (if deploying a server) - Environment variables

4

Deploy

Click Create Installation. Ryvn will automatically build your container and create the necessary resources in your environment.

Once deployed, you can monitor your installation’s status directly from the dashboard. View build logs, container status, resource utilization, and access application logs.

​
Automated Deployments with GitHub Actions

For server, Terraform, and Chart services, you can set up automated deployments using GitHub Actions. This integration enables:

  • Automatic builds and deployments when you push code
  • 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:

​
Troubleshooting

​
Application Requirements

Your application should:

  • Have a clear entry point (e.g., package.json for Node.js, requirements.txt for Python)
  • Listen on the port specified by PORT environment variable (if a server)
  • Handle process signals properly for graceful shutdowns
Make sure your application’s dependencies are properly specified in your repository.