1. Install Radius

Learn how to install Radius

In part one, you will install Radius on an existing Kubernetes cluster.

Prerequisites

  • A Kubernetes cluster
  • kubectl configured with the correct context
  • Your user must have the Kubernetes cluster-admin role
  • Node.js installed

Install the Radius CLI

Install the Radius CLI on your workstation with the appropriate installation script:


To try out a stable release visit the latest docs.

To install the latest edge release, first install ORAS. Then, run the following command to install the Radius CLI:

wget -q "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" -O - | /bin/bash -s edge

To try out a stable release visit the latest docs.

To install the latest edge release, first install ORAS. Then, run the following command to install the Radius CLI:

curl -fsSL "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" | /bin/bash -s edge

To try out a stable release visit the latest docs.

To install the latest edge release, first install ORAS. Then, run the following command to install the Radius CLI:

$script=iwr -useb "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.ps1"; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList edge

Open in GitHub Codespaces


Azure Cloud Shell is an interactive, authenticated, browser-accessible shell for managing Azure resources.

Azure Cloud Shell for bash doesn’t have a sudo command, so users are unable to install Radius to the default /usr/local/bin installation path. To install the Radius CLI to the home directory, run the following commands:

export RADIUS_INSTALL_DIR=./
wget -q "https://raw.githubusercontent.com/radius-project/radius/main/deploy/install.sh" -O - | /bin/bash

Visit Radius GitHub releases to select and download a specific version of the Radius CLI.

You may be prompted for your root or administrator password during installation. If you do not have permission to the default installation location, you can set the RADIUS_INSTALL_DIR environment variable with your preferred install directory.

Verify the Radius CLI is installed correctly by running rad version.

Install Radius

If you completed the quick start, you used rad initialize command which installs Radius and creates a pre-configured set of Resource Types, Recipes, and Environments. It is intended to get you started as quick as possible.

This tutorial is a step-by-step guide so uses the rad install kubernetes command which only installs Radius. Install Radius to the Kubernetes cluster in your Kubernetes context:

rad install kubernetes

Verify the pods are running:

kubectl get pods -n radius-system

You should see output similar to:

NAME                READY   STATUS    RESTARTS   AGE
applications-rp      1/1     Running   0          1m
bicep-de             1/1     Running   0          1m
controller           1/1     Running   0          1m
dashboard            1/1     Running   0          1m 
dynamic-rp           1/1     Running   0          1m
ucp                  1/1     Running   0          1m

Install the Bicep and Terraform extensions for VS Code (optional)

Radius uses the Bicep Infrastructure as Code (IaC) language to define application resources and either Bicep or Terraform to deploy resources. Installing the Bicep and Terraform extensions provides syntax highlighting, auto-completion, and other useful features for these languages.

In part two of this tutorial, you will create a PostgreSQL Resource Type.

Next Step: Create Resource Type