Skip to main content
Deploy applications directly from your GitHub repository. Ryvn supports two build methods:
  • Buildpacks: Automatically detects your application type and builds a container
  • Dockerfile: Builds your application using your custom Dockerfile
Both methods store images in our secure Ryvn Registry.

​
Prerequisites

Before you begin, ensure you have:
  • A GitHub repository with your application code (and optionally a Dockerfile)
  • 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
JobShort-lived task that runs to completion
TerraformInfrastructure as code service for managing cloud resources
ChartCustom Kubernetes workloads via Helm charts
4

Select Build Method and Repository

Choose your build method:
  • GitHub: Uses buildpacks to automatically detect and build your application
  • Dockerfile: Builds using your custom Dockerfile
Then select your GitHub repository from the dropdown
5

Configure Build

Select the branch to deploy from (defaults to main)For Dockerfile builds: Specify the Dockerfile location (defaults to ./Dockerfile)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 build your container (using buildpacks or your Dockerfile) 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 Helm 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

​
Buildpack Requirements

When using buildpacks, 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
  • Properly specify all dependencies in your repository
Make sure your application’s dependencies are properly specified in your repository.

​
Dockerfile Requirements

When using a Dockerfile, ensure your Dockerfile:
  • Uses specific base image tags (not latest)
  • Defines a valid ENTRYPOINT or CMD
  • Handles process signals properly for graceful shutdowns
latest tags are not allowed in base images as they make versioning and rollbacks unpredictable.