# IaaS Quickstart Guide

This guide walks through the exact sequence of purchases needed to go from an empty Sunrise Portal account to a running workload on Sunrise Cloud. For the concepts behind each step, see [How Sunrise Cloud Works](./how-it-works.md).

---

## Prerequisites

- An active Sunrise Portal account with a company profile and admin/purchasing privileges. If you don't have one yet, see [Create an Account](../../getting-started/create-an-account.md) and [Buy a Subscription](../../getting-started/buy-a-subscription.md) for the general account and checkout flow.
- A decision on how much CPU, RAM, storage, and (optionally) GPU your workload needs. See [Resource Pricing](../resource-pricing.md) for rates and minimums.

---

## Purchase Order

Infrastructure Services must be purchased in a fixed, dependency-based order. Each item below can only be created once the one before it exists in the portal.

**1. Resource Group (create) → 2. Capacity Pool → 3. Compute/Memory/Storage/GPU → 4. Namespace *or* Hosted Cluster**

All subscriptions are purchased from **Products** → **Infrastructure Services**, not from within a Resource Group or Capacity Pool. At checkout, select the Resource Group you created in Step 1.

---

## Step 1: Create a Resource Group

1. Sign in to the [Sunrise Portal](https://portal.ai.sunrise.ch).
2. Go to **Resource Groups**.

3. Click **Create Resource Group** and give it a name (for example, per department, project, or environment).

Resource Groups are free and exist purely to organize everything else you purchase.

---

## Step 2: Add a Capacity Pool

1. Go to **Products** and select **Infrastructure Services**.
2. Click **Add** on the **Capacity Pool** tile.
3. Proceed to checkout, select the Resource Group you created in Step 1, agree to the terms, and click **Buy subscription**.

A Capacity Pool is free to add. It doesn't do anything on its own, it's the container that the paid resources below get assigned to.

---

## Step 3: Purchase Resources

With a Capacity Pool in your Resource Group, purchase the compute resources it needs from **Products** → **Infrastructure Services**:

| Resource | Tile | Notes |
|---|---|---|
| **CPU (x86)** | CPU (x86) | Billed per vCPU/month. Supports bursting up to 150% of purchased cores. |
| **Memory** | Memory | Billed per GB/month. |
| **Storage** | Storage | Billed per GB/month, purchased in 100 GB increments (100 GB minimum). |
| **GPU** | GPU | NVIDIA H100 (80GB) or H200 (141GB), billed separately. Contact support for current rates. |

1. Go to **Products** → **Infrastructure Services**.
2. Click **Add** on each resource tile you need.
3. At checkout, select your Resource Group and complete the purchase.

You can add multiple tiles to your cart before checking out. See [Resource Pricing](../resource-pricing.md) for exact rates and a worked cost example.

---

## Step 4: Choose Namespace or Hosted Cluster

Once the pool has resources, decide how you want to consume them. This is the one branching decision in the purchase flow:

| | Namespace | Hosted Cluster |
|---|---|---|
| **What it is** | An isolated project on Sunrise' shared, managed OpenShift clusters | A dedicated OpenShift cluster with its own control plane |
| **Choose when** | You want quota- and RBAC-based isolation on shared infrastructure | You need full administrative access and stronger isolation than shared multi-tenancy provides |
| **Cost** | Free to add (draws from pool resources) | Flat CHF 1,000/month control plane fee, plus standard IaaS rates for workers and storage |

### Option A: Add a Namespace

1. Go to **Products** → **Infrastructure Services**.
2. Click **Add** on the **Namespace** tile.
3. At checkout, select your Resource Group and complete the purchase.

### Option B: Provision a Hosted Cluster

A Hosted Cluster can only be provisioned **after** its Capacity Pool and all required resources (compute, memory, storage) are already purchased, since it draws from that pool. Minimum sizing: 50 GB root volume per worker, 10 GB etcd storage per member (3 members). See [Hosted Cluster](../platform-architecture/hosted-cluster.md#sizing-and-configuration) for full sizing guidance.

1. Go to **Products** → **Infrastructure Services**, click **Add** on the **Hosted Cluster** tile, and complete checkout with your Resource Group selected.
2. Open the Hosted Cluster subscription in your Resource Group and fill in the release image, cores/memory per worker, number of workers, etcd storage, and root volume storage, then select the Capacity Pool to draw from.
3. Click **Provision**. Clusters take about 10 minutes to become available and start on a 60-day self-support trial license.

---

## After Purchase

- **Namespace workloads:** see [Access Your OpenShift](./access-your-openshift.md) to log in and deploy your first workload.
- **Hosted Cluster workloads:** the portal's **Configuration** tab shows your admin credentials and **Launch OpenShift Console** link once provisioning completes.

---

## Troubleshooting

| Issue | Resolution |
|---|---|
| Capacity Pool doesn't appear in the Hosted Cluster form | The pool must have compute, memory, and storage already provisioned before it appears in the provisioning form. |
| Can't add Storage below 100 GB | 100 GB is the minimum purchase and the only increment size. |
| Hosted Cluster provisioned but console/API not responding | Wait a minute or two after provisioning completes, then retry. |
| Unsure whether to use a Namespace or Hosted Cluster | See the comparison in [Step 4](#step-4-choose-namespace-or-hosted-cluster), or the [IaaS FAQ](../../faq/iaas/index.md#when-should-i-use-a-namespace-versus-a-hosted-cluster). |

---

## Notes

!!!tip Need help?
If you experience any issues or need assistance, please [contact support](https://support.ai.sunrise.ch/).
!!!

---

## Related Pages

- [How Sunrise Cloud Works](./how-it-works.md)
- [Resource Pricing](../resource-pricing.md)
- [Hosted Cluster](../platform-architecture/hosted-cluster.md)
- [Namespaces, Quotas and RBAC](../platform-architecture/namespaces-quotas-rbac.md)
- [Access Your OpenShift](./access-your-openshift.md)
- [IaaS FAQ](../../faq/iaas/index.md)
