Getting Started

If you're curious about Kubernetes and how it works, and want some inspiration on how to get started, see this quick-start guide we have written for new users. It has an overview of managed Kubernetes as a service, covers a few project ideas, some of the underlying technology, and other aspects at a glance.


How does my #KUBE100 Beta Credit work?

During the #KUBE100 beta programme, when your monthly invoice is issued, a discount of $70 or the invoice balance will be applied (whichever is lower). If your usage for the month through clusters, instances or other Civo resources exceeds $70 in a given month, the overage will be charged to the card on file.

How long will I get beta credit for?

The credit will be applied for the duration of the beta. As of the time of writing this (July 2020) we do not have an end date for the beta in mind. Any end to the beta period will be communicated to all users well in advance.

Can I limit my account so that I will not go over my credit?

You can set up a billing alert to notify you if you are approaching a particular value. We can also adjust your account quota (of deployable instances, volumes, etc) on request to prevent the likelihood of you exceeding your budget.

Do you bill for the master node?

Yes. Our managed Kubernetes service runs on k3s, which due to its small footprint allows the master node to also perform work alongside the other nodes.

Civo CLI Command-Line Tool

Can I administer my Kubernetes clusters from the command line?

We have written a comprehensive CLI tool to manage virtual machine instances, Kubernetes clusters and anything else to do with your Civo account. You can find out how to set it up here.

Check out this video for a run through of launching a cluster both of the Civo CLI and from the dashboard.

Can I run the CLI in Docker?

If you do not want to have the tool set up locally, you can run it as a Docker Alias and map your API key to the alias with these instructions.


Can I connect to my cluster nodes with SSH?

To provide consistency and predictability of service for Civo managed Kubernetes, SSH connections to the cluster nodes are not supported. While there are documented ways for you to execute into nodes given the credentials you already have, any changes you make this way risk breaking your cluster or preventing access to it, and are not supported. If you want to fully customize your cluster, you can create one using our infrastructure-as-a-service instances as nodes.

Another reason there is no SSH access is that we want to keep our options open about moving the architecture of the managed Kubernetes service to a virtualised platform such as k3v or similar in the future, and thus want to make sure users will experience a consistent service.

Why can't I see my cluster nodes on the instances page?

Related to the question above, because the nodes themselves are not accessible via SSH or managed outside the cluster, they will not appear as separate instances. If you need to restart a particular node, you can click on the "recycle" button on the cluster interface page.

Can I start a cluster without any pre-installed applications?

By default, k3s starts with Traefik as an Ingress Controller. This is to allow connections to your cluster. You can prevent Traefik from being installed when you start a cluster by deselecting it in the web UI (under 'Architecture') or by adding --remove-applications=traefik to your Civo CLI cluster creation command.

Remember that starting up a cluster with no Ingress Controller means you will manually have to configure one to allow access to applications.

Do all nodes have public IP addresses?

Only the master node has a public IP address. It receives traffic to your cluster, and routes it to your worker nodes in the form of a load balancer, as well as processing tasks itself.

Can I change the underlying operating system running Kubernetes?

We aim for the underlying operating system to be as lightweight as possible to allow for maximum resources to be allocated to Kubernetes and your applications. To this end, we may change the underlying OS, but as this is a managed service this will be the same for all users.

Can I pool different-sized nodes into the same cluster?

We are planning to implement pooling of nodes of different sizes (e.g. 2x medium, 2x large) in the same cluster, and will annouce when this feature is available.

Community and Support

Where can I find the Civo community?

We have a Civo community Slack workspace which all beta users are invited to join. All Civo staff have a Civo logo next to their names. You will also see users marked with an Ambassador badge. Ambassadors are trusted and knowledgeable community members who will be glad to help out if you have questions about the service.


Can I contribute content (blog posts, learn guides)?

We would love to see you document your experience, whether it is on your own site, on Medium/ or as a Civo learn guide. If you write up a piece, submit a pull request at the Civo Community Content to make sure we know about it.

Find out other ways to contribute here.

Feature Requests and Bug Reports

I have found a bug, how can I report it?

The best place to report bugs on Civo is on our GitHub issue tracker. If you do not have a GitHub account, you can contact us using the "contact us" button found at the bottom of every page.

How do I suggest a feature to Civo?

New feature suggestions are gladly accepted through your dashboard, under Suggestions.


Can I remove an installed marketplace application?

As of time of writing (May 2020) the only way to remove a marketplace application is to remove it by running kubectl delete -f on the resource and manifest files. Please note that while the marketplace application will get removed from your cluster, this will not be reflected on the web UI for the moment.

Swag and Contributing to Civo

How do I get Civo merchandise?

Where possible, we send out a swag pack to everyone accepted into the KUBE100 beta who has added a rewards address in their Civo account. Please be aware there is no tracking number for this, and please allow at least 6 weeks for delivery.

Civo Merchandise

We sometimes send out higher value swag to members of our community who really go the extra mile. If you want to get involved you could submit a learn guide or help out your fellow Civo users in our Slack channel.

Find out more ways you can contribute to Civo here.


What is k3s and how does it relate to Kubernetes (k8s)? Why did you decide to go with k3s?

Our CTO Andy wrote a great post about precisely this topic, and why we decided to go with Rancher's k3s as the Kubernetes distribution of choice. k3s is fully compatible with upstream Kubernetes (K8S).

What can I use k3s for? What use cases is Civo Kubernetes good for?

Take a look at this blog post that explores use cases and the advantages k3s gives you. We are also keen to hear from you about your use cases! See "Can I contribute content" above.