{"id":18469995,"url":"https://github.com/civo/cli","last_synced_at":"2026-03-04T12:07:12.376Z","repository":{"id":38705551,"uuid":"235366627","full_name":"civo/cli","owner":"civo","description":"Our Command Line Interface (CLI) for interacting with your Civo resources","archived":false,"fork":false,"pushed_at":"2026-01-13T14:24:37.000Z","size":2029,"stargazers_count":201,"open_issues_count":33,"forks_count":98,"subscribers_count":19,"default_branch":"master","last_synced_at":"2026-01-14T18:29:27.937Z","etag":null,"topics":["civo","civo-cli","cli","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/civo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-01-21T14:51:02.000Z","updated_at":"2026-01-13T14:24:41.000Z","dependencies_parsed_at":"2025-11-27T17:10:16.320Z","dependency_job_id":null,"html_url":"https://github.com/civo/cli","commit_stats":{"total_commits":672,"total_committers":52,"mean_commits":"12.923076923076923","dds":0.5610119047619048,"last_synced_commit":"670e3e2d8e4895dd115f8c2bb2f977f1e988606c"},"previous_names":["civo/cli-go"],"tags_count":219,"template":false,"template_full_name":null,"purl":"pkg:github/civo/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/civo%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/civo%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/civo%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/civo%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/civo","download_url":"https://codeload.github.com/civo/cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/civo%2Fcli/sbom","scorecard":{"id":283971,"data":{"date":"2025-08-11","repo":{"name":"github.com/civo/cli","commit":"66c801d21328686cc06e7e634e5262fb9e178498"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.5,"checks":[{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":10,"reason":"14 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/go.yml:1","Warn: no topLevel permission defined: .github/workflows/goreleaser.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/go.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/go.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/goreleaser.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/goreleaser.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/goreleaser.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/goreleaser.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/goreleaser.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/goreleaser.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/goreleaser.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/civo/cli/goreleaser.yml/master?enable=pin","Warn: containerImage not pinned by hash: docker/Dockerfile:1: pin your Docker image by updating alpine:latest to alpine:latest@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1","Warn: downloadThenRun not pinned by hash: .github/workflows/go.yml:24","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned","Info:   1 out of   1 goCommand dependencies pinned","Info:   0 out of   1 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Branch-Protection","score":5,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'master'","Info: 'force pushes' disabled on branch 'master'","Info: 'branch protection settings apply to administrators' is required to merge on branch 'master'","Info: 'stale review dismissal' is required to merge on branch 'master'","Warn: required approving review count is 1 on branch 'master'","Warn: codeowners review is not required on branch 'master'","Warn: 'last push approval' is disabled on branch 'master'","Warn: no status checks found to merge onto branch 'master'","Info: PRs are required in order to make changes on branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.4.3 not signed: https://api.github.com/repos/civo/cli/releases/239618549","Warn: release artifact v1.4.2 not signed: https://api.github.com/repos/civo/cli/releases/238924316","Warn: release artifact v1.4.1 not signed: https://api.github.com/repos/civo/cli/releases/234249802","Warn: release artifact v1.4.0 not signed: https://api.github.com/repos/civo/cli/releases/226121565","Warn: release artifact v1.3.0 not signed: https://api.github.com/repos/civo/cli/releases/223016120","Warn: release artifact v1.4.3 does not have provenance: https://api.github.com/repos/civo/cli/releases/239618549","Warn: release artifact v1.4.2 does not have provenance: https://api.github.com/repos/civo/cli/releases/238924316","Warn: release artifact v1.4.1 does not have provenance: https://api.github.com/repos/civo/cli/releases/234249802","Warn: release artifact v1.4.0 does not have provenance: https://api.github.com/repos/civo/cli/releases/226121565","Warn: release artifact v1.3.0 does not have provenance: https://api.github.com/repos/civo/cli/releases/223016120"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/goreleaser.yml:9"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-q7pp-wcgr-pffx"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T16:44:50.206Z","repository_id":38705551,"created_at":"2025-08-17T16:44:50.206Z","updated_at":"2025-08-17T16:44:50.206Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30079565,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T11:57:42.557Z","status":"ssl_error","status_checked_at":"2026-03-04T11:56:10.793Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["civo","civo-cli","cli","go","golang"],"created_at":"2024-11-06T10:12:20.463Z","updated_at":"2026-03-04T12:07:12.357Z","avatar_url":"https://github.com/civo.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Civo Command-Line Client\n\n## Introduction\n\nCivo CLI is a tool to manage your [Civo.com](https://www.civo.com) account from the terminal. The [Civo web control panel](https://www.civo.com/account/) has a user-friendly interface for managing your account, but in case you want to automate or run scripts on your account, or have multiple complex services, the command-line interface outlined here will be useful. This guide will cover the set-up and usage of the Civo CLI tool with examples.\n\n**STATUS:** This project is currently under active development and maintenance.\n\n## Table of contents\n\n- [Introduction](#introduction)\n- [Global Options](#global-options)\n- [Set-Up](#set-up)\n- [Version/Updating CLI](#update)\n- [Docker Usage](#docker-usage)\n- [API Keys](#api-keys)\n- [Instances](#instances)\n- [Kubernetes clusters](#kubernetes-clusters)\n- [Kubernetes applications](#kubernetes-applications)\n- [Domains and Domain Records](#domains-and-domain-records)\n- [Firewalls](#firewalls)\n- [Networks](#networks)\n- [Database Backup and Restore](./doc/DTABASE_BACKUP_RESTORE.md)\n- [Object Stores](#object-stores)\n- [Object Store Credentials](#object-store-credentials)\n- [Load Balancers](#load-balancers)\n- [Quota](#quota)\n- [Sizes](#sizes)\n- [SSH Keys](#ssh-keys)\n- [DiskImages](#disk-image)\n- [Volumes](#volumes)\n- [Teams](#teams)\n- [Permissions](#permissions)\n- [Region](#region)\n- [Enabling shell autocompletion](#enabling-shell-autocompletion)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Set-up\n\nCivo CLI is built with Go and distributed as binary files, available for multiple operating systems and downloadable from \u003chttps://github.com/civo/cli/releases\u003e.\n\n### Installing on macOS\n\nIf you have a Mac, you can install it using [Homebrew](https://brew.sh):\n\n```sh\nbrew tap civo/tools\nbrew install civo\n```\n\nor if you prefer you can run this in the console:\n\n```sh\ncurl -sL https://civo.com/get | sh\n```\n\n### Installing on Windows\n\nCivo CLI is available to download on windows via Chocolatey and Scoop\n\nFor installing via Chocolatey you need [Chocolatey](https://chocolatey.org/install) package manager installed on your PC.\n\n- run the following command after confirming Chocolatey on your PC\n\n ```\n choco install civo-cli\n ```\n\n and it will install Civo CLI on your PC.\n\nFor installing via Scoop you need [Scoop](https://scoop.sh/) installed as a package manager, then:\n\n- add the extras bucket with\n\n```\nscoop bucket add extras\n```\n\n- install civo with\n\n```\nscoop install civo\n```\n\nYou will also, of course, need a Civo account, for which you can [register here](https://www.civo.com/signup).\n\n### Installing on Linux\n\nFor Linux Civo CLI can be installed by various methods.\n\n- Install via the direct shell script:\n\n```sh\ncurl -sL https://civo.com/get | sh\n```\n\n- Install via the brew package manager, as shown in the above instructions for MacOS.\n\n- Install via wget, specifying the [release version](https://github.com/civo/cli/releases) you want.\n\n**_Note that the version in the example below may not be the latest. Specify the version based on the latest available if you are using this method._**\n\n```\nwget https://github.com/civo/cli/releases/download/v1.0.40/civo-1.0.40-linux-amd64.tar.gz\ntar -xvf civo-1.0.40-linux-amd64.tar.gz\nchmod +x civo\nmv ./civo /usr/local/bin/\n```\n\n-   You can also build the binary, but make sure you have go installed,\n\n```sh\ngit clone https://github.com/civo/cli.git\ncd cli\nmake\ncd ..\ncp -r cli $HOME\nexport PATH=\"$HOME/cli:$PATH\"\n```\n\nWith this, we have installed the Civo CLI successfully. Check it is working by running any of the following commands.\n\n**Note:** For the first time when you are running, make sure you set your current region. Check [Region](#region) for more information.\n\n### Running the Civo CLI tool and getting help\n\nTo use the tool, simply run `civo` with your chosen options. You can find context-sensitive help for commands and their options by invoking the `help` or `-h` command:\n`civo help`,\n`civo instance help`,\n`civo instance create help`\nand so on. The main components of Civo CLI are outlined in the following sections.\n\n## Version/Updating CLI\n\nEvery user receives a reminder to update the CLI once in 24 hours as well as notified to update the CLI version in case of any error. Run `civo update` to update the CLI to the latest version.\n\n## Docker Usage\n\nCivo's CLI utility can also run within a Docker container, if you prefer to keep your base OS clean.\n\nTo run, you generally will want to map the API key for persistence.\n\n```sh\ntouch $HOME/.civo.json\ndocker run -it --rm -v $HOME/.civo.json:/.civo.json civo/cli:latest\n```\n\nYou can also use the Kubernetes options of the CLI. Kubectl is included inside our image, to use it you just need to mount the configuration in the container.\n\n```sh\ntouch $HOME/.civo.json\nmkdir $HOME/.kube/\ntouch $HOME/.kube/config\ndocker run -it --rm -v $HOME/.civo.json:/.civo.json -v $HOME/.kube/config:/root/.kube/config civo/cli:latest\n```\n\nTo make usage easier, an alias is recommended. Here's an example how to set one to the same command as would be used if installed directly on the system, and using the Docker image:\n\nUbuntu etc:\n\n```sh\nalias civo=\"docker run -it --rm -v $HOME/.civo.json:/.civo.json civo/cli:latest\"\n# Maybe put the above line in ~/.bash_profile or ~/.zshrc\ncivo sshkey list\ncivo instance list\ncivo instance create --size g2.xsmall\ncivo k8s list\n```\n\nFor Fedora users:\n\n```sh\nalias civo=\"docker run -it --rm -v $HOME/.civo.json:/.civo.json:Z -v $HOME/.kube/config:$HOME/.kube/config:Z civo/cli:latest\"\n```\n\nHere's an example how to set an alias and get started with Kubernetes.\n\n```sh\nalias civo=\"docker run -it --rm -v $HOME/.civo.json:/.civo.json -v $HOME/.kube/config:$HOME/.kube/config civo/cli:latest\"\n# Maybe put the above line in ~/.bash_profile or ~/.zshrc\ncivo sshkey list\ncivo instance list\ncivo instance create --size g2.xsmall\ncivo k8s list\n```\n\n## Global Options\n\nThe civo cli have multiple global options, that you can use, like this:\n\n```\n      --config string   config file (default is $HOME/.civo.json)\n  -f, --fields string   output fields for custom format output (use -h to determine fields)\n  -h, --help            help for civo\n  -o, --output string   output format (json/human/custom) (default \"human\")\n      --pretty          Print pretty the json output\n      --region string   Choose the region to connect to, if you use this option it will use it over the default region\n  -y, --yes             Automatic yes to prompts; assume \"yes\" as answer to all prompts and run non-interactive\n```\n\n## API Keys\n\n#### Introduction\n\nIn order to use the command-line tool, you will need to authenticate yourself to the Civo API using a special key. You can find an automatically-generated API key or regenerate a new key at [https://www.civo.com/api](https://www.civo.com/api). The CLI have a global env variable call `CIVO_TOKEN` if this is set, the CLI will use this token instead of the one in the config file. This is useful for scripting situations or CI/CD pipelines. When you set the `CIVO_TOKEN` you will see a new apikey entry with the name `tempKey` in the `civo apikey list` command.\n\n#### Adding a current API Key to your account\n\nYou can add the API Key to the CLI tool through the API Keys command.\n`civo apikey add apikey_name apikey` such as:\n\n```sh\n$ civo apikey add Demo_Test_Key DAb75oyqVeaE7BI6Aa74FaRSP0E2tMZXkDWLC9wNQdcpGfH51r\n  Saved the API Key Demo_Test_Key as DAb75oyqVeaE7BI6Aa74FaRSP0E2tMZXkDWLC9wNQdcpGfH51r\n```\n\nAs you can have multiple API keys stored to handle multiple accounts, you will need to tell which key the tool should use to authenticate with `civo apikey current [apikey_name]`. This sets your chosen API key as the default key to use for any subsequent commands:\n\n```sh\n$ civo apikey current Demo_Test_Key\n  Set the default API Key to be Demo_Test_Key\n```\n\nBy default, the Civo account credentials API Key along with other settings like region will be saved in a file called `.civo.json` in the user home directory. The default location of the file can be changed using the environment variable `CIVO_CONFIG`.\n\n#### Managing and listing API keys\n\nYou can list all stored API keys in your configuration by invoking `civo apikey list` or remove one by name by using `civo apikey remove apikey_name`.\n\nTo see the secret key you can use `civo apikey show` which will show only the default key, to see others just use `civo apikey show NAME`\n\n```sh\ncivo apikey list\n+--------------+---------+\n| Name         | Default |\n+--------------+---------+\n| my_username  | \u003c=====  |\n+--------------+---------+\n```\n\n```sh\ncivo apikey show my_username\n+-------------+------------+\n| Name        | Key        |\n+-------------+------------+\n| my_username | secret_key |\n+-------------+------------+\n```\n\n## Instances\n\n#### Introduction\n\nAn instance is a virtual server running on the Civo cloud platform. They can be of variable size and you can run any number of them up to your quota on your account.\n\n#### Creating an instance\n\nYou can create an instance by running `civo instance create` with a hostname parameter, as well as any options you provide:\n\n```sh\nOptions:\n  -t, --diskimage string     the instance's disk image name (from 'civo diskimage ls' command)\n  -l, --firewall string      the instance's firewall you can use the Name or the ID\n  -h, --help                 help for create\n  -s, --hostname string      the instance's hostname\n  -u, --initialuser string   the instance's initial user\n  -r, --network string       the instance's network you can use the Name or the ID\n  -p, --publicip string      This should be either \"none\" or \"create\" (default \"create\")\n  -i, --size string          the instance's size (from 'civo instance size' command)\n  -k, --sshkey string        the instance's ssh key you can use the Name or the ID\n  -g, --tags string          the instance's tags\n  -w, --wait                 wait until the instance's is ready\n\n```\n\nExample usage:\n\n```sh\n$ civo instance create --hostname=api-demo.test --size g3.small  --diskimage=ubuntu-focal --initialuser=demo-user\n  The instance api-demo.test has been created\n\n$ civo instance show api-demo.test\n              ID : 112f2407-fb89-443e-bd0e-5ddabc4682c6\n        Hostname : api-demo.test\n          Status : ACTIVE\n            Size : g3.small\n       Cpu Cores : 1\n             Ram : 2048\n        SSD disk : 25\n          Region : LON1\n      Network ID : 28244c7d-b1b9-48cf-9727-aebb3493aaac\n\n   ID : ubuntu-bionic\n     Snapshot ID :\n    Initial User : demo-user\nInitial Password : demo-user\n         SSH Key :\n     Firewall ID : c9e14ae8-b8eb-4bae-a687-9da4637233da\n            Tags :\n      Created At : Mon, 01 Jan 0001 00:00:00 UTC\n      Private IP : 192.168.1.7\n       Public IP : 74.220.21.246\n\n----------------------------- NOTES -----------------------------\n```\n\nYou will be able to see the instance's details by running `civo instance show api-demo.test` as above.\n\n#### Disk images and instance sizes\n\nYou can view the Disk images by running `civo diskimage ls`\n\n```sh\n$ civo diskimage ls\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| ID                                   | Name            | Version        | State     | Distribution |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 9b661c46-ac4f-46e1-9f3d-aaacde9b4fec | debian-9        |              9 | available | debian       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| d927ad2f-5073-4ed6-b2eb-b8e61aef29a8 | ubuntu-focal    |          20.04 | available | ubuntu       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| a4204155-a876-43fa-b4d6-ea2af8774560 | debian-10       |             10 | available | debian       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| eda67ea0-4282-4945-9b7b-d3e1cba1d987 | ubuntu-jammy    |          22.04 | available | ubuntu       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 170db96f-8458-44aa-83ca-0c31fb81a835 | rocky-9-1       |            9.1 | available | rocky        |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 25fbbd96-d5ec-4d08-9c75-a5e154dabf9b | debian-11       |             11 | available | debian       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 21613daa-a66b-44fc-87f5-b6db566d8f91 | ubuntu-cuda11-8 | 22.04-cuda11-8 | available | ubuntu       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| ffb6fd93-cb06-4e8d-8058-46003b78e2ff | talos-v1.2.8    | 1.25.5         | available | talos        |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 9a16a77e-1a1f-45c8-87fd-6d1a19eeaac9 | talos-v1.5.0    | 1.27.0         | available | talos        |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n| 13232803-0928-4634-9ab8-476bff29ef1b | ubuntu-cuda12-2 | 22.04-cuda12-2 | available | ubuntu       |\n+--------------------------------------+-----------------+----------------+-----------+--------------+\n```\n\nYou can view the instance sizes list by running `civo size ls`\n\n```sh\n$ civo size ls\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| Name               | Description                    | Type       | CPU | RAM     | SSD |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.xsmall          | Extra Small                    | Instance   |   1 |    1024 |  25 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.small           | Small                          | Instance   |   1 |    2048 |  25 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.medium          | Medium                         | Instance   |   2 |    4096 |  50 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.large           | Large                          | Instance   |   4 |    8192 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.xlarge          | Extra Large                    | Instance   |   6 |   16384 | 150 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.2xlarge         | 2X Large                       | Instance   |   8 |   32768 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.kube.xsmall    | Extra Small - Standard         | Kubernetes |   1 |    1024 |  30 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.kube.small     | Small - Standard               | Kubernetes |   1 |    2048 |  40 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.kube.medium    | Medium - Standard              | Kubernetes |   2 |    4096 |  50 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.kube.large     | Large - Standard               | Kubernetes |   4 |    8192 |  60 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4p.kube.small     | Small - Performance            | Kubernetes |   4 |   16384 |  60 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4p.kube.medium    | Medium - Performance           | Kubernetes |   8 |   32768 |  80 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4p.kube.large     | Large - Performance            | Kubernetes |  16 |   65536 | 120 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4p.kube.xlarge    | Extra Large - Performance      | Kubernetes |  32 |  131072 | 180 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4c.kube.small     | Small - CPU optimized          | Kubernetes |   8 |   16384 |  60 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4c.kube.medium    | Medium - CPU optimized         | Kubernetes |  16 |   32768 |  80 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4c.kube.large     | Large - CPU optimized          | Kubernetes |  32 |   65536 | 120 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4c.kube.xlarge    | Extra Large - CPU optimized    | Kubernetes |  64 |  131072 | 180 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4m.kube.small     | Small - RAM optimized          | Kubernetes |   2 |   16384 |  60 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4m.kube.medium    | Medium - RAM optimized         | Kubernetes |   4 |   32768 |  80 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4m.kube.large     | Large - RAM optimized          | Kubernetes |   8 |   65536 | 120 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4m.kube.xlarge    | Extra Large - RAM optimized    | Kubernetes |  16 |  131072 | 180 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.xsmall       | Extra Small                    | Database   |   1 |    2048 |  20 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.small        | Small                          | Database   |   2 |    4096 |  40 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.medium       | Medium                         | Database   |   4 |    8192 |  80 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.large        | Large                          | Database   |   6 |   16384 | 160 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.xlarge       | Extra Large                    | Database   |   8 |   32768 | 320 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.db.2xlarge      | Double Extra Large             | Database   |  10 |   65536 | 640 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.kf.small        | Small - CPU optimized          | KfCluster  |   4 |   16384 |  60 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.kf.medium       | Medium - CPU optimized         | KfCluster  |   8 |   32768 |  80 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.kf.large        | Large - CPU optimized          | KfCluster  |  16 |   65536 | 120 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g3.kf.xlarge       | Extra Large - CPU optimized    | KfCluster  |  32 |  131072 | 180 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.xsmall         | xSmall - Standard              | Instance   |   1 |    1024 |  25 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.small          | Small - Standard               | Instance   |   1 |    2048 |  25 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.medium         | Medium - Standard              | Instance   |   2 |    4096 |  50 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.large          | Large - Standard               | Instance   |   4 |    8192 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.xlarge         | Extra Large - Standard         | Instance   |   6 |   16384 | 150 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4s.2xlarge        | 2X Large - Standard            | Instance   |   8 |   32768 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.kube.small     | Small - Nvidia A100 80GB       | Kubernetes |  12 |  131072 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.kube.medium    | Medium - Nvidia A100 80GB      | Kubernetes |  24 |  262144 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.kube.large     | Large - Nvidia A100 80GB       | Kubernetes |  48 |  524288 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.kube.xlarge    | Extra Large - Nvidia A100 80GB | Kubernetes |  96 | 1048576 | 100 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.small          | Small - Nvidia A100 80GB       | Instance   |  12 |  131072 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.medium         | Medium - Nvidia A100 80GB      | Instance   |  24 |  262144 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.large          | Large - Nvidia A100 80GB       | Instance   |  48 |  524288 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.xlarge         | Extra Large - Nvidia A100 80GB | Instance   |  96 | 1048576 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.small       | Small - Nvidia A100 40GB       | Instance   |   8 |   65536 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.medium      | Medium - Nvidia A100 40GB      | Instance   |  16 |  131072 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.large       | Large - Nvidia A100 40GB       | Instance   |  32 |  262133 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.xlarge      | Extra Large - Nvidia A100 40GB | Instance   |  64 |  524288 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.kube.small  | Small - Nvidia A100 40GB       | Kubernetes |   8 |   65536 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.kube.medium | Medium - Nvidia A100 40GB      | Kubernetes |  16 |  131072 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.kube.large  | Large - Nvidia A100 40GB       | Kubernetes |  32 |  262133 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| g4g.40.kube.xlarge | Extra Large - Nvidia A100 40GB | Kubernetes |  64 |  524288 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.x1      | Small - Nvidia L40S 40GB       | Instance   |  12 |  131072 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.x2      | Medium - Nvidia L40S 40GB      | Instance   |  24 |  262133 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.x4      | Large - Nvidia L40S 40GB       | Instance   |  48 |  524288 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.x8      | Extra Large - Nvidia L40S 40GB | Instance   |  96 | 1048576 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.kube.x1 | Small - Nvidia L40S 40GB       | Kubernetes |  12 |  131072 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.kube.x2 | Medium - Nvidia L40S 40GB      | Kubernetes |  24 |  262133 | 200 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.kube.x4 | Large - Nvidia L40S 40GB       | Kubernetes |  48 |  524288 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n| an.g1.l40s.kube.x8 | Extra Large - Nvidia L40S 40GB | Kubernetes |  96 | 1048576 | 400 |\n+--------------------+--------------------------------+------------+-----+---------+-----+\n\n```\n\n#### Viewing the Default User Password For an Instance\n\nYou can view the default user's password for an instance by running `civo instance password ID/hostname`\n\n```sh\n$ civo instance password api-demo.test\nThe instance api-demo.test (112f2407-fb89-443e-bd0e-5ddabc4682c6) has the password BrbXNW2RUYLe (and user demo-user)\n```\n\nYou can also run this command with the option `-o` and `-f` to get only the password output, useful for scripting situations:\n\n```sh\n$ civo instance password api-demo.test -o custom -f Password\nBrbXNW2RUYLe\n```\n\n#### Viewing Instance Public IP Address\n\nIf an instance has a public IP address configured, you can display it using `civo instance public-ip ID/hostname`:\n\n```sh\n$ civo instance show api-demo.test -o custom -f public_ip\n74.220.21.246\n```\n\nThe above example uses `-o` and `-f` to display only the IP address in the output.\n\n#### Setting Firewalls\n\nInstances can make use of separately-configured firewalls. By default, an instance is created with default all port open firewall rules set. If you want to secure your instances more, so you will need to configure some rules (see [Firewalls](#firewalls) for more information). Once you have configured the rules you can check it by running `civo firewall ls`\n\n```sh\n$ civo firewall ls\n+--------------------------------------+------------------------------------+---------+-------------+-----------------+\n| ID                                   | Name                               | Network | Total rules | Total Instances |\n+--------------------------------------+------------------------------------+---------+-------------+-----------------+\n| c9e14ae8-b8eb-4bae-a687-9da4637233da | Default (all open)                 | Default |           3 |               0 |\n| f79db64d-41f0-4be0-ae80-ce4499164319 | Kubernetes cluster: Demo           | Default |           2 |               0 |\n+--------------------------------------+------------------------------------+---------+-------------+-----------------+\n```\n\nYou can take the firewall ID and use it to associate a firewall with an instance, use the command `civo instance firewall ID/hostname firewall_id`. For example:\n\n```sh\n$ civo instance firewall api-demo.test f79db64d-41f0-4be0-ae80-ce4499164319\nSet the firewall for the instance api-demo.test (112f2407-fb89-443e-bd0e-5ddabc4682c6) to Kubernetes cluster: Demo (f79db64d-41f0-4be0-ae80-ce4499164319)\n```\n\n#### Listing Instances\n\nYou can list all instances associated with a particular API key by running `civo instance list`.\n\n#### Listing Instances sizes\n\nYou can list all instances sizes by running `civo instance size`.\n\n#### Rebooting/Restarting Instances\n\nA user can reboot an instance at any time, for example to fix a crashed piece of software. Simply run `civo instance reboot instanceID/hostname`. You will see a confirmation message:\n\n```sh\n$ civo instance reboot api-demo.test\n Rebooting api-demo.test. Use 'civo instance show api-demo.test' to see the current status.\n```\n\nIf you prefer a hard reboot, you can run `civo instance hard-reboot instanceID/hostname` instead.\n\n#### Removing Instances\n\nYou can use a command to remove an instance from your account. This is immediate, so use with caution! Any snapshots taken of the instance, as well as any mapped storage, will remain.\nUsage: `civo instance remove instanceID/hostname`. For example:\n\n```sh\n$ civo instance remove api-demo.test\nThe instance (api-demo.test) has been deleted\n```\n\n#### Stopping (Shutting Down) and Starting Instances\n\nYou can shut down an instance at any time by running `civo instance stop instanceID/hostname`:\n\n```sh\n$ civo instance stop api-demo.test\n Stopping api-demo.test. Use 'civo instance show api-demo.test' to see the current status.\n```\n\nAny shut-down instance on your account can be powered back up with `civo instance start instanceID/hostname`:\n\n```sh\n$ civo instance start api-demo.test\n Starting api-demo.test. Use 'civo instance show api-demo.test' to see the current status.\n```\n\n#### (Re)Tagging an Instance\n\nTags can be useful in distinguishing and managing your instances. You can retag an instance using `civo instance tags instanceID/hostname 'tag1 tag2 tag3...'` as follows:\n\n```sh\n$ civo instance tags api-demo.test 'ubuntu demo'\n The instance api-demo.test (b5f82fa7-b8e4-44aa-9dda-df02dab71d6c) has been tagged with ubuntu demo. Use 'civo instance show api-demo.test' to see the current tags.'\n$ civo instance show api-demo.test\n              ID : b5f82fa7-b8e4-44aa-9dda-df02dab71d6c\n        Hostname : api-demo.test\n          Status : SHUTOFF\n            Size : g3.small\n       Cpu Cores : 1\n             Ram : 2048\n        SSD disk : 25\n          Region : LON1\n      Network ID : 28244c7d-b1b9-48cf-9727-aebb3493aaac\n   Disk image ID : ubuntu-bionic\n     Snapshot ID :\n    Initial User : demo-user\nInitial Password : demo-user\n         SSH Key :\n     Firewall ID : c9e14ae8-b8eb-4bae-a687-9da4637233da\n            Tags : ubuntu demo\n      Created At : Mon, 01 Jan 0001 00:00:00 UTC\n      Private IP : 192.168.1.7\n       Public IP : 74.220.16.23\n\n----------------------------- NOTES -----------------------------\n```\n\n#### Updating Instance Information\n\nIn case you need to rename an instance or add notes, you can do so with the `instance update` command as follows:\n\n```sh\n$ civo instance update api-demo.test --hostname api-demo-renamed.test --notes 'Hello, world!'\nThe instance api-demo-renamed.test (b5f82fa7-b8e4-44aa-9dda-df02dab71d6c) has been updated\n\n$ civo instance show api-demo-renamed.test\n              ID : 715f95d1-3cee-4a3c-8759-f9b49eec34c4\n        Hostname : api-demo-renamed.test\n          Status : ACTIVE\n            Size : g3.small\n       Cpu Cores : 1\n             Ram : 2048\n        SSD disk : 25\n          Region : LON1\n      Network ID : 28244c7d-b1b9-48cf-9727-aebb3493aaac\n   Disk image ID : ubuntu-bionic\n     Snapshot ID :\n    Initial User : demo-user\nInitial Password : demo-user\n         SSH Key :\n     Firewall ID : c9e14ae8-b8eb-4bae-a687-9da4637233da\n            Tags :\n      Created At : Mon, 01 Jan 0001 00:00:00 UTC\n      Private IP : 192.168.1.7\n       Public IP : 74.220.21.246\n\n----------------------------- NOTES -----------------------------\n\nHello, world!\n```\n\nYou can leave out either the `--name` or `--notes` switch if you only want to update one of the fields.\n\n#### Upgrading (Resizing) an Instance\n\nProvided you have room in your Civo quota, you can upgrade any instance up in size. You can upgrade an instance by using `civo instance upgrade instanceID/hostname new_size` where `new_size` is from the list of sizes at `civo sizes ls`:\n\n```sh\n$ civo instance upgrade api-demo-renamed.test g3.medium\n The instance api-demo-renamed.test (9579d478-a09e-4196-a08c-f52545a90fea) is being upgraded to g3.medium\n\n$ civo instance show api-demo-renamed.test\n          Status : ACTIVE\n            Size : g3.medium\n       Cpu Cores : 2\n             Ram : 4096\n        SSD disk : 50\n          Region : LON1\n      Network ID : 28244c7d-b1b9-48cf-9727-aebb3493aaac\n   Disk image ID : ubuntu-bionic\n     Snapshot ID :\n    Initial User : demo-user\nInitial Password : demo-user\n         SSH Key :\n     Firewall ID : c9e14ae8-b8eb-4bae-a687-9da4637233da\n            Tags : ubuntu, demo\n      Created At : Mon, 01 Jan 0001 00:00:00 UTC\n      Private IP : 192.168.1.9\n       Public IP : 74.220.17.71\n\n----------------------------- NOTES -----------------------------\n\nHello, world!\n```\n\nPlease note that resizing can take a few minutes.\n\n\n### Recovery Mode\n\nRecovery mode allows you to boot your instance into a recovery environment for troubleshooting.\n\n```sh\n# Enable recovery mode for an instance\ncivo instance recovery enable INSTANCE_ID/HOSTNAME\n\n# Disable recovery mode for an instance\ncivo instance recovery disable INSTANCE_ID/HOSTNAME\n\n# Check recovery mode status\ncivo instance recovery-status INSTANCE_ID/HOSTNAME\n```\n\nThe recovery-status command supports custom output formats with the following fields:\n* id - The instance ID\n* hostname - The instance hostname\n* status - Current recovery mode status\n\n\n### VNC Access\n\nThe VNC command allows you to access your instance through a browser-based VNC console.\n\n```sh\n# Open VNC console (default duration)\ncivo instance vnc INSTANCE_ID/HOSTNAME\n\n# Open VNC console with custom duration\ncivo instance vnc INSTANCE_ID/HOSTNAME --duration 2h\n```\n\nThe `--duration` flag accepts Go's duration format:\n* \"30m\" - 30 minutes\n* \"1h\" - 1 hour\n* \"24h\" - 24 hours\n\nWhen executed, the command will:\n1. Enable VNC access for the specified instance\n2. Generate a secure VNC URL\n3. Automatically open the console in your default browser\n4. Attempt to connect for up to 35 seconds before timing out\n\n\n## Kubernetes clusters\n\n#### Introduction\n\nYou can manage Kubernetes clusters on Civo using the Kubernetes subcommands.\n\n#### List clusters\n\nTo see your created clusters, call `civo kubernetes list`:\n\n```sh\n$ civo kubernetes list\n+--------------------------------------+----------------+--------+-------+-------+--------+\n| ID                                   | Name           | Region | Nodes | Pools | Status |\n+--------------------------------------+----------------+--------+-------+-------+--------+\n| 5604340f-caa3-4ac1-adb7-40c863fe5639 | falling-sunset | NYC1   |     2 |     1 | ACTIVE |\n+--------------------------------------+----------------+--------+-------+-------+--------+\n```\n\n#### Listing kubernetes sizes\n\nYou can list all kubernetes sizes by running `civo kubernetes size`.\n\n```sh\n$ civo kubernetes size\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| Name               | Description                    | Type       | CPU Cores | RAM MB  | SSD GB | Selectable |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4s.kube.xsmall    | Extra Small - Standard         | Kubernetes |         1 |    1024 |     30 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4s.kube.small     | Small - Standard               | Kubernetes |         1 |    2048 |     40 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4s.kube.medium    | Medium - Standard              | Kubernetes |         2 |    4096 |     50 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4s.kube.large     | Large - Standard               | Kubernetes |         4 |    8192 |     60 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4p.kube.small     | Small - Performance            | Kubernetes |         4 |   16384 |     60 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4p.kube.medium    | Medium - Performance           | Kubernetes |         8 |   32768 |     80 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4p.kube.large     | Large - Performance            | Kubernetes |        16 |   65536 |    120 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4p.kube.xlarge    | Extra Large - Performance      | Kubernetes |        32 |  131072 |    180 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4c.kube.small     | Small - CPU optimized          | Kubernetes |         8 |   16384 |     60 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4c.kube.medium    | Medium - CPU optimized         | Kubernetes |        16 |   32768 |     80 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4c.kube.large     | Large - CPU optimized          | Kubernetes |        32 |   65536 |    120 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4c.kube.xlarge    | Extra Large - CPU optimized    | Kubernetes |        64 |  131072 |    180 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4m.kube.small     | Small - RAM optimized          | Kubernetes |         2 |   16384 |     60 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4m.kube.medium    | Medium - RAM optimized         | Kubernetes |         4 |   32768 |     80 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4m.kube.large     | Large - RAM optimized          | Kubernetes |         8 |   65536 |    120 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4m.kube.xlarge    | Extra Large - RAM optimized    | Kubernetes |        16 |  131072 |    180 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.kube.small     | Small - Nvidia A100 80GB       | Kubernetes |        12 |  131072 |    100 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.kube.medium    | Medium - Nvidia A100 80GB      | Kubernetes |        24 |  262144 |    100 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.kube.large     | Large - Nvidia A100 80GB       | Kubernetes |        48 |  524288 |    100 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.kube.xlarge    | Extra Large - Nvidia A100 80GB | Kubernetes |        96 | 1048576 |    100 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.40.kube.small  | Small - Nvidia A100 40GB       | Kubernetes |         8 |   65536 |    200 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.40.kube.medium | Medium - Nvidia A100 40GB      | Kubernetes |        16 |  131072 |    400 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.40.kube.large  | Large - Nvidia A100 40GB       | Kubernetes |        32 |  262133 |    400 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| g4g.40.kube.xlarge | Extra Large - Nvidia A100 40GB | Kubernetes |        64 |  524288 |    400 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| an.g1.l40s.kube.x1 | Small - Nvidia L40S 40GB       | Kubernetes |        12 |  131072 |    200 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| an.g1.l40s.kube.x2 | Medium - Nvidia L40S 40GB      | Kubernetes |        24 |  262133 |    200 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| an.g1.l40s.kube.x4 | Large - Nvidia L40S 40GB       | Kubernetes |        48 |  524288 |    400 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n| an.g1.l40s.kube.x8 | Extra Large - Nvidia L40S 40GB | Kubernetes |        96 | 1048576 |    400 | Yes        |\n+--------------------+--------------------------------+------------+-----------+---------+--------+------------+\n\n```\n\n#### Create a cluster\n\nYou can create a cluster by running `civo kubernetes create` with a cluster name parameter, as well as any options you provide:\n\n```bash\n-a, --applications string          optional, use names shown by running 'civo kubernetes applications ls'\n-p, --cni-plugin string            optional, possible options: flannel,cilium. (default \"flannel\")\n-c, --create-firewall              optional, create a firewall for the cluster with all open ports\n-e, --existing-firewall string     optional, ID of existing firewall to use\n-u, --firewall-rules string        optional, can be used if the --create-firewall flag is set, semicolon-separated list of ports to open (default \"default\")\n-h, --help                         help for create\n-m, --merge                        merge the config with existing kubeconfig if it already exists.\n-t, --network string               the name of the network to use in the creation (default \"default\")\n-n, --nodes int                    the number of nodes to create (the master also acts as a node). (default 3)\n-r, --remove-applications string   optional, remove default application names shown by running  'civo kubernetes applications ls'\n --save                         save the config\n-s, --size string                  the size of nodes to create. (default \"g4s.kube.medium\")\n --switch                       switch context to newly-created cluster\n-v, --version string               the k3s version to use on the cluster. Defaults to the latest. Example - 'civo k3s create --version 1.21.2+k3s1' (default \"latest\")\n-w, --wait                         a simple flag (e.g. --wait) that will cause the CLI to spin and wait for the cluster to be ACTIVE\n```\n\n*Note*\n\n- The '--create-firewall' will open the ports 80,443 and 6443 in the firewall if '--firewall-rules' is not used.\n- The '--create-firewall' and '--existing-firewall' flags are mutually exclusive. You can't use them together.\n- The '--firewall-rules' flag need to be used with '--create-firewall'.\n- The '--firewall-rules' flag can accept:\n  - You can pass 'all' to open all ports.\n  - An optional end port using 'start_port-end_port' format (e.g. 8000-8100)\n  - An optional CIDR notation (e.g. 0.0.0.0/0)\n  - When no CIDR notation is provided, the port will get 0.0.0.0/0 (open to public) as default CIDR notation\n  - When a CIDR notation is provided without slash and number segment, it will default to /32\n  - Within a rule, you can use comma separator for multiple ports to have same CIDR notation\n  - To separate between rules, you can use semicolon symbol and wrap everything in double quotes (see below)\n    So the following would all be valid:\n  - \"80,443,6443:0.0.0.0/0;8080:1.2.3.4\" (open 80,443,6443 to public and 8080 just for 1.2.3.4/32)\n  - \"80,443,6443;6000-6500:4.4.4.4/24\" (open 80,443,6443 to public and 6000 to 6500 just for 4.4.4.4/24)\n\n```sh\n$ civo kubernetes create my-first-cluster\nCreated Kubernetes cluster my-first-cluster\n```\n\n#### Adding pools the cluster\n\nYou can add more pools to your cluster live (obviously 1 is the minimum) while the cluster is running. It takes the name of the cluster (or the ID), the parameter of `--nodes` which is the new number of nodes to run and `--size` which is the size of the pool,\nif `--node` and `--size` are not specified, the default values will be used.\n\n```sh\ncivo kubernetes node-pool create my-first-cluster\nThe pool (8064c7) was added to the cluster (my-first-cluster)\n```\n\n#### Scaling pools in the cluster\n\nYou can scale a pool in your cluster, while the cluster is running. It takes the name of the cluster (or the ID), the pool ID (at least 6 characters), and `--nodes` which is the new number of nodes in the pool. You can get the pool ID details form `civo k3s show my-first-cluster`\n\n```sh\ncivo kubernetes node-pool scale my-first-cluster pool-id --nodes 5\n```\n\n#### Deleting pools in the cluster\n\nYou can delete a pool in your cluster. It takes the name of the cluster (or the ID) and the pool ID (at least 6 characters)\n\n```sh\ncivo kubernetes node-pool delete my-first-cluster pool-id\n```\n\n#### Recycling nodes in your cluster\n\nIf you need to recycle a particular node in your cluster for any reason, you can use the `recycle` command. This requires the name or ID of the cluster, and the name of the node you wish to recycle preceded by `--node=`:\n\n```sh\n$ civo k8s recycle my-first-cluster --node=k3s-my-first-cluster-5ae1561e-node-pool-a56f\nThe node (k3s-my-first-cluster-5ae1561e-node-pool-a56f) was recycled\n```\n\n_Note:_ When a node is recycled, it is fully deleted. The recycle command does not [drain](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/) a node, it simply deletes it before building a new node and attaching it to a cluster. It is intended for scenarios where the node itself develops an issue and must be replaced with a new one.\n\n#### Viewing or Saving the cluster configuration\n\nTo output a cluster's configuration information, you can invoke `civo kubernetes config cluster-name`. This will output the `kubeconfig` file to the screen.\n\nYou can save a cluster's configuration to your local `~/.kube/config` file. This requires `kubectl` to be installed. Usage:\n\n```sh\ncivo kubernetes config my-first-cluster -s\nSaved config to ~/.kube/config\n```\n\nIf you already have a `~/.kube/config` file, any cluster configuration that is saved will be _overwritten_ unless you also pass the `--merge` option. If you have multiple cluster configurations, merging allows you to switch contexts at will. If you prefer to save the configuration in another place, just use the parameter `--local-path` or `-p` and the path. If you use `--switch` the cli will automatically change the kubernetes context to the new cluster.\n\n```sh\ncivo kubernetes config my-first-cluster -s --merge\nMerged with main kubernetes config: /root/.kube/config\nSaved configuration to: /root/.kube/config\n\nAccess your cluster with:\nkubectl config use-context my-first-cluster\nkubectl get node\n```\n\n#### Renaming the cluster\n\nAlthough the name isn't used anywhere except for in the list of clusters (e.g. it's not in any way written in to the cluster), if you wish to rename a cluster you can do so with:\n\n```sh\ncivo kubernetes rename my-first-cluster --name=\"Production\"\nKubernetes cluster my-first-cluster is now named Production\n```\n\n#### Starting a cluster without default applications\n\nBy default, `Traefik` is bundled in with `k3s`. If you want to set up a cluster without Traefik, you can use the `remove-applications` option in the creation command to start a cluster without it:\n\n```sh\ncivo kubernetes create --remove-applications=Traefik-v2-nodeport --nodes=2 --wait\n```\n\nThe command uses the application name as displayed by running `civo kubernetes applications ls`.\n\n#### Removing the cluster\n\nIf you're completely finished with a cluster you can delete it with:\n\n```sh\ncivo kubernetes remove my-first-cluster\n```\n\n## Kubernetes Applications\n\n#### Introduction\n\nYou can install applications from the [Applications Marketplace](https://github.com/civo/kubernetes-marketplace/) through the command-line interface. The installation depends on whether you are creating a new cluster or adding applications to an existing cluster.\n\n#### Listing Available Applications\n\nTo get an up-to-date list of available applications on the Marketplace, run `civo kubernetes apps list`. At the time of writing, the list looked like this:\n\n```text\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| Name                        | Version           | Category     | Plans                                                                                      | Dependencies                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| acorn                       | 0.7.1             | management   | Disabled Auto-TLS, Enabled Auto-TLS                                                        |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| ambassador-edge-stack       | 3.8.0             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| apisix-ingress-controller   | 1.6.0             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| argo-rollouts               | v1.4.1            | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| argo-workflows              | v3.0.3            | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| argocd                      | v2.11.4           | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| aspnet                      | 5.0.5             | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| atmo                        | 0.2.2             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| bitwarden-passwordless-dev  | 1.0.74            | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| bitwarden-unified           | 2024.1.0          | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| blackbox-exporter           | 5.8.2             | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| cerbos                      | 0.34.0            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| cert-manager                | v1.15.1           | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| chaos-mesh                  | (default)         | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| civo-cluster-autoscaler     | v1.25.0           | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| code-server                 | 3.11.1            | management   | 1GB, 2GB, 5GB                                                                              | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| dapr                        | 1.11.0            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| devtron                     |                   | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| dynamic-pv-scaler           | 0.1.0             | storage      |                                                                                            | prometheus-operator               |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| edp                         | 3.8.1             | ci_cd        | GitHub, GitLab                                                                             | argocd, tekton, traefik2-nodeport |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| enroute-onestep             | 0.8.0             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| epinio                      | v1.11.1           | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| falco                       |              0.27 | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| ferretdb                    | 1.22.0            | database     | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| flagsmith                   | 0.39.0            | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| flux                        | Latest            | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| gatekeeper                  | 3.4.0             | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| ghost                       | 5.87.1            | management   | 5GB, 10GB, 15GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| gimlet                      | v0.17.2           | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| gitea                       | 1.12.5            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| gitlab                      | 16.2.3            | management   | Community edition, Enterprise edition                                                      | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| gloo-edge                   | latest            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| haproxy                     |               1.5 | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| helm                        | 2.16.5            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| istio                       | multiple          | architecture | Istio Latest, Istio v1.10.1, Istio v1.9.5, Istio v1.8.6                                    |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| jenkins                     | 2.452.2           | ci_cd        | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| joomla                      |               5.2 | management   | 5GB, 10GB, 20GB                                                                            | mariadb:5GB, cert-manager         |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kafka                       | 2.7.0             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| keda                        | 2.14.0            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| keptn                       | 0.8.7             | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| ketch                       | 0.7.0             | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| keycloak                    | 25.0.1            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kong-ingress-controller     | 3.0.1             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kriten                      | 4.0.1             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kube-hunter                 | latest            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubeclarity                 | Latest            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubefirst                   | v2.4.6            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubeflow                    | 1.6.0-rc.1        | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubenav                     | 3.1.0             | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubernetes-dashboard        | v2.4.0            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubernetes-external-secrets | 0.9.14            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubesphere                  | v3.4.1            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubevela                    | 1.0.1             | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubevious                   | v1.0.3            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kubewarden                  | v1.14.0           | security     |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| kyverno                     | 1.8.2             | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| linkerd                     | Latest            | architecture | Linkerd Minimal, Linkerd \u0026 Jaeger, Linkerd with Dashboard, Linkerd with Dashboard \u0026 Jaeger |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| litmuschaos                 | 2.0.0             | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| loki                        | v2.9.11           | monitoring   |                                                                                            | prometheus-operator               |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| longhorn                    | 1.3.2             | storage      |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| maesh                       | v1.4.5            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| mariadb                     | 11.4.2            | database     | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| metrics-server              | (default)         | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| minio                       | 2019-08-29        | storage      | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| mongodb                     | 4.2.12            | database     | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| netdata                     | Latest            | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| neuvector                   | latest            | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| nextcloud                   | 29.0.3            | management   | 5GB, 10GB, 20GB                                                                            | mariadb:5GB, cert-manager         |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| nexus3                      | 3.30.1            | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| nginx                       | latest            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| ngrok-ingress-controller    | 0.12.1            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| nodered                     | 1.2.7             | architecture | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| openfaas                    | 0.18.0            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| openobserve                 | v0.8.1            | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| otomi                       | 1.0.0             | management   |                                                                                            | metrics-server                    |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| paralus                     | 0.2.3             | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| parca                       | v0.15.0           | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| percona-mysql               | 1.11.0            | database     | 10GB, 20GB, 50GB                                                                           |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| permission-manager          | 1.6.0             | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| pmm                         | 2.36.0            | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| polaris                     | 7.3.2             | security     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| portainer                   | 2.16.2            | management   | Community edition, Business edition                                                        |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| postgresql                  |              16.3 | database     | 5GB, 10GB, 20GB                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| projectsveltos              | v0.29.1           | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| prometheus-operator         | 0.38.1            | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| pyroscope                   | 0.2.5             | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| rabbitmq                    | 3.13.4-management | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| rancher                     | 2.8.5             | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| redis                       | 7.2-alpine        | database     |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| rekor                       | 0.2.2             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| reloader                    | v0.0.125          | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| rqlite                      | 8.26.6            | database     | 1GB, 5GB, 10GB, 3Replicas                                                                  |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| sealed-secrets              | v0.26.2           | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| selenium                    |                 4 | ci_cd        |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| shipa                       | 1.7.2             | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| siglens-oss                 | 0.1.22            | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| spinkube                    | v0.1.0            | management   |                                                                                            | cert-manager                      |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| system-upgrade-controller   | v0.6.2            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| tekton                      | v0.50.5           | ci_cd        |                                                                                            | metrics-server                    |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| traefik2-loadbalancer       | 2.11.0            | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| traefik2-nodeport           | 2.9.4             | architecture |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| unifi-controller            | stable-6          | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| uptime-kuma                 | 1.23.3            | monitoring   | 1GB, 2GB                                                                                   |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| vault                       | 0.24.0            | security     | Standalone, Dev, High-Availability                                                         |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| volcano                     | v1.9.0            | management   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| weavescope                  | v1.13.2           | monitoring   |                                                                                            |                                   |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n| wordpress                   | 5.6.2             | management   | 5GB, 10GB, 20GB                                                                            | mariadb:5GB                       |\n+-----------------------------+-------------------+--------------+--------------------------------------------------------------------------------------------+-----------------------------------+\n```\n\n#### Show Applications details when is installed in the cluster\n\nThis option will be allow you to see the post-install instruction of every app installed in the cluster\n\n```sh\ncivo kubernetes application show Traefik apps-demo-cluster\n```\n\nthe first parameter is for the name of the app and the second is the name of the cluster\n\n#### Installing Applications Onto a New Cluster\n\nTo specify applications to install onto a new cluster, list them at cluster creation by specifying their `name` from the list above:\n\n```sh\ncivo kubernetes create apps-demo-cluster --nodes=2  --applications=Redis,Linkerd\n```\n\nNow, if you take a look at the cluster's details, you will see the newly-installed applications listed:\n\n```sh\n$ civo kubernetes show apps-demo\n                ID : 1199efbe-e2a5-4d25-a32f-0b7aa50082b2\n              Name : apps-demo-cluster\n           # Nodes : 2\n              Size : g2.medium\n            Status : ACTIVE\n           Version : 0.8.1\n      API Endpoint : https://[Cluster-IP]:6443\n         Master IP : [Cluster-IP]\n      DNS A record : 1199efbe-e2a5-4d25-a32f-0b7aa50082b2.k8s.civo.com\n\nNodes:\n+------------------+----------------+--------+\n| Name             | IP             | Status |\n+------------------+----------------+--------+\n| kube-master-1e91 |      (IP)      | ACTIVE |\n| kube-node-e678   |      (IP)      | ACTIVE |\n+------------------+----------------+--------+\n\nInstalled marketplace applications:\n+---------+-----------+-----------+--------------+\n| Name    | Version   | Installed | Category     |\n+---------+-----------+-----------+--------------+\n| Traefik | (default) | Yes       | architecture |\n| Linkerd | 2.5.0     | Yes       | architecture |\n| Redis   | 3.2       | Yes       | database     |\n+---------+-----------+-----------+--------------+\n```\n\n**Note:** Applications like `metrics-server` are installed by default on any new cluster you create. If you don't need to install the default applications, use the `--remove-applications` flag as below:\n\n```sh\ncivo kubernetes create apps-demo-cluster --nodes=2 --applications=Redis,Linkerd --remove-applications=metrics-server\n```\n\n#### Installing Applications to an Existing Cluster\n\nIf you want to add a new application to an existing cluster, you can do so by running the `civo applications` command specifying the cluster and the app(s) you wish to add:\n\n```sh\n$ civo kubernetes applications add Longhorn --cluster=apps-demo\nAdded Longhorn 0.5.0 to Kubernetes cluster apps-demo-cluster\n```\n\n#### Installing Applications That Require Plans\n\nSome applications, specifically database apps, require a storage plan that you can specify at installation time from the list of plan options. If you do not provide a plan for an application that requires one, the CLI will notify you and suggest a default size:\n\n```sh\n$ civo kubernetes applications add mariadb --cluster=apps-demo\nYou requested to add MariaDB but didn't select a plan. Please choose one... (5GB, 10GB, 20GB) [5GB]: 10GB\nThank you, next time you could use \"MariaDB:10GB\" to choose automatically\nAdded MariaDB 10.4.7 to Kubernetes cluster apps-demo-cluster\n```\n\n## Domains and Domain Records\n\n#### Introduction\n\nWe host reverse DNS for all instances automatically. If you'd like to manage forward (normal) DNS for your domains, you can do that for free within your account.\n\nThis section is effectively split in to two parts: 1) Managing domain names themselves, and 2) Managing records within those domain names.\n\nWe don't offer registration of domains names, this is purely for hosting the DNS. If you're looking to buy a domain name, we recommend [LCN.com](https://www.lcn.com/) for their excellent friendly support and very competitive prices.\n\n#### Set Up a New Domain\n\nAny user can add a domain name (that has been registered elsewhere) to be managed by Civo.com. You should adjust the nameservers of your domain (through your registrar) to point to `ns0.civo.com` and `ns1.civo.com`.\n\nThe command to set up a new domain is `civo domain create domainname`:\n\n```sh\n$ civo domain create civoclidemo.xyz\nCreated a domain called civoclidemo.xyz with ID 418181b2-fcd2-46a2-ba7f-c843c331e79b\n```\n\nYou can then proceed to add DNS records to this domain.\n\n#### List Domain Names\n\nTo see your created domains, call `civo domain list`:\n\n```sh\n$ civo domain list\n+--------------------------------------+-----------------+\n| ID                                   | Name            |\n+--------------------------------------+-----------------+\n| 418181b2-fcd2-46a2-ba7f-c843c331e79b | civoclidemo.xyz |\n+--------------------------------------+-----------------+\n```\n\n#### Deleting a Domain\n\nIf you choose to delete a domain, you can call `civo domain remove domain_id` and have the system immediately remove the domain and any associated DNS records. This removal is immediate, so use with caution.\n\n#### Creating a DNS Record\n\nA DNS record creation command takes a number of options in the format `civo domain record create domain_id [options]` and the options are this.\n\n```text\nOptions:\n-n, --name string    the name of the record\n-p, --priority int   the priority of record only for MX record\n-t, --ttl int        The TTL of the record (default 600)\n-e, --type string    type of the record (A, CNAME, TXT, SRV, MX)\n-v, --value string   the value of the record\n```\n\nUsage is as follows:\n\n```sh\n$ civo domain record create civoclidemo.xyz -n www -t 600 -e A -v 192.168.1.1\n\nCreated a record www1 for civoclidemo.xyz with a TTL of 600 seconds and with a priority of 0 with ID 4e181dde-bde8-4744-8984-067f957a7d59\n```\n\n#### Listing DNS Records\n\nYou can get an overview of all records you have created for a particular domain by requesting `civo domain record list domain.name`:\n\n```sh\n$ civo domain record list civoclidemo.xyz\n+--------------------------------------+------+---------------------+-------------+------+----------+\n| ID                                   | Type | Name                | Value       | TTL  | Priority |\n+--------------------------------------+------+---------------------+-------------+------+----------+\n| 4e181dde-bde8-4744-8984-067f957a7d59 | A    | www.civoclidemo.xyz | 192.168.1.1 | 1000 | 0        |\n+--------------------------------------+------+---------------------+-------------+------+----------+\n```\n\n#### Deleting a DNS Record\n\nYou can remove a particular DNS record from a domain you own by requesting `civo domain record remove record_id`. This immediately removes the associated record, so use with caution:\n\n```sh\n$ civo domain record remove 4e181dde-bde8-4744-8984-067f957a7d59\nThe domain record called www with ID 4e181dde-bde8-4744-8984-067f957a7d59 was deleted\n```\n\n## Firewalls\n\n#### Introduction\n\nYou can configure custom firewall rules for your instances using the Firewall component of Civo CLI. These are freely configurable, however customers should be careful to not lock out their own access to their instances. By default, all ports are closed for custom firewalls.\n\nFirewalls can be configured with rules, and they can be made to apply to your chosen instance(s) with subsequent commands.\n\n#### Configuring a New Firewall\n\nTo create a new Firewall, use `civo firewall create new_firewall_name`:\n\n```sh\n$ civo firewall create civocli_demo\nCreated a firewall called civocli_demo with ID ab2a25d7-edd4-4ecd-95c4-58cb6bc402de\n```\n\nYou can also create a firewall without any default rules by using the flag `-r` or `--create-rules` set to `false`. In both cases, the usage is like:\n\n```bash\ncivo firewall create new_firewall_name --create-rules=false\n\n```\n\nYou will then be able to **configure rules** that allow connections to and from your instance by adding a new rule using `civo firewall rule create firewall_id` with the required and your choice of optional parameters, listed here and used in an example below:\n\n```text\nOptions:\n-a, --action string      the action of the rule can be allow or deny (default is allow) (default \"allow\")\n-c, --cidr string        the CIDR of the rule you can use (e.g. -c 10.10.10.1/32,148.2.6.120/32) (default \"0.0.0.0/0\")\n-d, --direction string   the direction of the rule can be ingress or egress (default is ingress) (default \"ingress\")\n-e, --endport string     the end port of the rule\n-h, --help               help for create\n-l, --label string       a string that will be the displayed as the name/reference for this rule\n-p, --protocol string    the protocol choice (TCP, UDP, ICMP) (default \"TCP\")\n-s, --startport string   the start port of the rule\n```\n\nExample usage:\n\n```sh\n$ civo firewall rule create civocli_demo --startport=22 --direction=ingress --label='SSH access for CLI demo' -a allow\n New rule SSH access for CLI demo created\n\n$ civo firewall rule list civocli_demo\n+-----------------------","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcivo%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcivo%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcivo%2Fcli/lists"}