# Getting Started

This guide helps you set up and start using a Kubernetes cluster with MetaKube Core. It assumes you're already familiar with Kubernetes concepts.

## Prerequisites

- An account with access to MetaKube Core
- `kubectl` installed on your local machine
- Basic knowledge of Kubernetes

## Step 1: Create a Cluster

1. Log in to the [Dashboard](<https://dashboard.syseleven.de/>).
2. Navigate to MetaKube Core and click "Create Cluster".
3. Choose your desired configuration: - Kubernetes version - Region - Initial node pool size
4. Click "Create" to provision your cluster.

For detailed cluster creation options, see [Create Cluster](<https://documentation.syseleven.de/en/products/metakube-core/usage/clusters/index.md>).

## Step 2: Connect to Your Cluster

Once your cluster is ready:

1. In the cluster details page, click "Download Kubeconfig".
2. Save the kubeconfig file and set your `KUBECONFIG` environment variable:

```shell
export KUBECONFIG=/path/to/your/kubeconfig
```

3. Verify the connection:

   ```shell
   kubectl get nodes
   ```

## Step 3: Deploy a Sample Application

Deploy a simple nginx application:

```shell
kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=LoadBalancer
```

This creates a deployment and exposes it via a LoadBalancer. For more on networking, see [Load Balancers](<https://documentation.syseleven.de/en/products/metakube-core/concepts/networking/load-balancers/index.md>).

## Step 4: Access Your Application

Check the external IP of your service:

```shell
kubectl get services nginx
```

Once the external IP appears, you can access your nginx server at `http://<EXTERNAL-IP>`.

> [!TIP]

Make sure that [OpenStack Security Groups](<https://documentation.syseleven.de/en/products/openstack-cloud/usage/networking/security-groups/index.md>) allow access to the ports you want to use.

## Step 5: Scale Your Application

Scale the deployment to 3 replicas:

```shell
kubectl scale deployment nginx --replicas=3
```
