​
Overview

Welcome to Ryvn! Let’s get your first application up and running.

This tutorial uses your own cloud account—you’ll need AWS, GCP, or Azure access.

​
1. Choose a Service Type

  1. Open the Ryvn Dashboard
  2. Go to the Services tab
  3. Click Create Service in the top-right corner
  4. For this tutorial, select Server

​
2. Connect Your GitHub

  1. Click Connect GitHub
  2. Select the repository containing your application and click Connect

​
3. Configure an Environment

  1. Go to the Environments tab
  2. Click Create Environment in the top-right corner
  3. Give your environment a name production
  4. Select the production release channel

Release channels link services to environments. When you push code changes, services publish releases to release channels. Environments subscribed to those channels automatically deploy new releases.

  1. Click Create Environment

​
4. Provision in Your Cloud

  1. Click View Environment
  2. Click Self Setup
  3. Click Start Provisioning
  4. Choose your cloud provider (AWS, GCP, or Azure)
  5. Fill out the form with your cloud provider details
  6. Click Continue
  7. Click Create Permissions
  8. Follow the instructions for your cloud provider
  9. Go back to Ryvn and wait for the environment to be provisioned

​
5. Deploy Your Server

  1. Go to the Services tab
  2. Click on your service
  3. Click Deploy to new environment in the top-right corner
  4. Select the production environment
  5. Click Deploy

​
6. Open Your Application

Every server installation on Ryvn is assigned a unique ryvn.app URL. Find this URL on the installation tile on the canvas.

​
Explore Service Types

Here’s an overview of all available service types:

Service TypeDescription
ServerFor applications that handle HTTP requests like APIs and web apps.
WorkerFor processing asynchronous tasks and jobs, like queue processors and batch operations.
JobScheduled or one-off tasks, ideal for data cleanup and periodic operations.
ChartCustom Kubernetes workloads for complex applications requiring specific features.
TerraformInfrastructure provisioning and cloud resource management as code.