Skip to content
This repository has been archived by the owner on Jun 18, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
November 4, 2020 12:21
November 11, 2019 10:33
November 4, 2020 12:21
August 19, 2019 13:38
August 7, 2020 13:49
July 3, 2019 19:37
August 3, 2018 10:38
July 2, 2019 14:14
June 24, 2021 13:47
November 4, 2020 12:21
November 11, 2019 10:33

Thanks for all your interest in this project. At present time, this project is on hold and the repo will be archived until we're ready to pick it up again!

Rio [Beta]

Build Status Go Report Card

Rio is an Application Deployment Engine for Kubernetes that can be layered on top of any standard Kubernetes cluster. Consisting of a few Kubernetes custom resources and a CLI to enhance the user experience, users can easily deploy services to Kubernetes and automatically get continuous delivery, DNS, HTTPS, routing, monitoring, autoscaling, canary deployments, git-triggered builds, and much more. All it takes to get going is an existing Kubernetes cluster and the rio CLI.

Rio is currently in Beta.

Connect with us on the #rio channel on the rancher slack


See here for detailed documentation and guides.

Quick Start

  1. Have a Kubernetes 1.15 or newer cluster running.

    k3s, RKE, Minikube, Docker For Mac Edge, GKE, AKS, EKS, see the install docs for info and requirements.

  2. Run

# Download the CLI (available for macOS, Windows, Linux)
$ curl -sfL | sh -   # or manually from

# Setup your cluster for Rio
$ rio install

# Make sure all the pods are up and running. These may take several minutes.
$ rio -n rio-system pods

# Run a sample service
$ rio run -p 80:8080

# Check the status
$ rio ps
$ rio info


Copyright (c) 2014 - 2020 Rancher Labs, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.