# Project Setup

# Prerequisites

You need:

1. Helm charts for your application. If you don’t have any, feel free to get started with our buzzword counter application. (opens new window) To learn more, visit helm (opens new window).

2. A Unikube account.

  • Creating an account is super quick. Just click here (opens new window).
  • You want to delete your login data? No problem. Just drop us a line at support@unikube.io
  • Alternatively, you can use these test credentials (without creating your own account) to try out the CLI, before creating your own account:
User: sandbox@unikube.io Password: #4kEMU8aPm

3. A docker image that you’d like to swap into the cluster. Makes the most sense when it’s an image (maybe a newer version) of one of your services from your helm charts.

# Online Project Creation

Since Unikube was built with team collaboration in mind, we created a neat web service that allows you to manage access and updates of your Kubernetes resources with ease.

After you login into app.unikube.io (opens new window), you’re asked to join or create a new organization. Feel free to choose any name and invite your colleagues to join.

Create a new organization1 Create a new organization2

After creating a new organization you’ll be redirected to the project overview page. Since you probably haven’t created a project yet, it will look something like this:

Create a project list

Alright! Let’s hit the “Add new Project” button on the top right corner. You’ll be presented with a form to create a new project. Enter a title, the http(s) path to your helm charts repository, the branch which should be cloned as well as the access credentials if needed. Finish with clicking “Next”! You’ll be asked to add team members from your organization - feel free to skip this step.

TIP

You could use our example helm charts for your first project: Buzzword Charts (opens new window).

If you're working with helm charts you need to define the values with which the charts are rendered. When opening the project edit the deck, you would like to install later.

Create a new organization1

In the decks settings make sure a values path is set, if you are using our example this might be /buzzword-counter/values.yaml.

Create a new organization1

TIP

A deck is the smallest installable unit in on Unikube.

That’s it for the online setup! Let’s get this thing running on your machine!