In order to get started with Hakuna Cloud services you just need 5 minutes to configure your Cloud Provider and the instance you want Hakuna to manage.

Install Hakuna Cloud CLI

  1. Install the nodejs runtime (version >=8.0) - NodeJS documentation
  2. Open a terminal and run npm install -g

Login in Hakuna Cloud

Now you have to login in Hakuna Cloud.

  1. Inside a terminal type and run hakuna user login. This command will prompt all instructions to correctly configure an account. An environment with a browser it’s needed to run this command because the authentication will be done through it.

Provider Configuration

Now you have to configure Hakuna Cloud proxy providing your Cloud Provider credentials letting Hakuna Cloud call Cloud Provider API. Run the following commands to configure a provider:

  1. Open a terminal on your local machine and run hakuna provider create.
    You will be asked to choose from all available providers, a.k.a. flavours.
    Choose your cloud providers from the list.

  2. Choose an arbitrary name for the cloud provider.
    For example “Hakuna < provider >”

  3. Insert the credentials information required by the hakuna CLI.
    Those data depends on Cloud Provider you have chosen at step 1 and are used by Hakuna Cloud to call the API of your provider.

  4. Right after adding the credentials, the hakuna CLI will validate them and you will get a confirmation about the successfully created provider.

You can find more information about how Hakuna Cloud works with your Cloud Provider clicking on the following links:

Vhost Configuration

Once you have created the provider, you need to configure the instance and Hakuna Cloud will start to manage it.

  1. Run hakuna vhost create

  2. Choose your cloud provider from the list.
    For example “DigitalOcean”

  3. Choose your previously created provider.
    For example “Hakuna < provider >”

  4. Choose the instance you want Hakuna Cloud to manage.
    The tool will show you a list of available instances (depending on provider and credentials).

  5. Specify a domain name for that vhost.
    For example “”.

  6. Configure your DNS to point the hostname to one of our public load balancers.
    North America:

    Example: CNAME

    You can also create and use a hostname provided by us. Just use the hakuna hostname create command to let Hakuna create a DNS record for you; only * hostnames can be created.

  7. After the DNS propagation ends, visit the hostname and Hakuna Cloud will start working!