# Quickstart

```{warning}
This site is still under development.
```

## Create a new Cluster

Navigate to the dashboard of your <a href="https://dashboard.capi.cloud" target="_blank">Capi Console</a>.
In the left side menu click on **Clusters** to view the list of clusters.

![](/_static/images/quickstart/img1.png)

Now, click on **Create** to create your first cluster.

![](/_static/images/quickstart/img2.png)

Assign a name to your cluster and click on **Create**.

![](/_static/images/quickstart/img3.png)

## Wait for the cluster to be ready

Wait for the cluster to be ready. This may take a few minutes.

![](/_static/images/quickstart/img4.png)

## Connect to the cluster

When the cluster is ready, click on **Kubeconfig** to download the kubeconfig file.

![](/_static/images/quickstart/img5.png)

On your local machine, set the `KUBECONFIG` environment variable to the path of the downloaded file.

```bash
export KUBECONFIG=/path/to/kubeconfig
```

## Deploy an application

Now, let's deploy an application to the cluster. We will deploy the [nginx](https://www.nginx.com/) web server.

```bash
kubectl create deployment nginx --image=nginx
```

## Expose the application

Expose the application using an <a href="https://kubernetes.io/docs/concepts/services-networking/ingress/" target="_blank">Ingress</a>.

First, create a ClusterIP service to expose the application within the cluster.

```bash
kubectl expose deployment nginx --port=80
```

Then create an Ingress to expose the application outside the cluster.

```bash
kubectl apply -f - <<EOF
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx
spec:
  rules:
    - host: nginx.example.com
      http:
        paths:
        - path: /
          pathType: Prefix
          backend:
          service:
            name: nginx
              port:
                number: 80
```

## Access the application

To access the application, you need to add an entry to your `/etc/hosts` file or to your DNS server.

Get the IP address of the cluster.

```bash
cat $KUBECONFIG | grep server
# server: https://<dns-name>
```

Resolve the DNS name to an IP address.

```bash
dig +short <dns-name>
# <ip-address>
```

Add an entry to your `/etc/hosts` file, replacing `<ip-address>` with the IP address of the cluster.
Or add an entry to your DNS server.

```bash
echo "<ip-address> nginx.example.com" | sudo tee -a /etc/hosts
```

## Cleanup

You can delete the cluster directly from the web interface by clicking on **Delete**.

![](/_static/images/quickstart/img6.png)