Configuration Options

CLI Configuration Options

The Uffizzi CLI has several configuration options, so that each time you run a command, you don't have to pass values for your account, project, location of your kubeconfig file, etc. These configurations are stored in ~/.config/uffizzi/config_default.json.


The config_default.json file stores the configuration properties for your Uffizzi CLI installation. You can set/unset these properties by running the uffizzi config set / unset commands. It is not recommended to edit this file manually. See the CLI reference for details.


server (string) - The Uffizzi API server. Defaults to (Uffizzi Cloud)
account (object) - The Uffizzi account object (int) - The Uffizzi account ID (string) - The Uffizzi account name
project (string) - A URL-compatible slug generated from your Project name previous_current_contexts (array) - Helper config that tracks the previous and current cluster contexts. Used to switch back to previous context when the current cluster is deleted.

Setup Wizard

Once you've installed the Uffizzi CLI, you can run uffizzi config to launch an interactive configuration wizard. The CLI configuration is stored in ~/.config/uffizzi/config_default.json.

uffizzi config


Set the Uffizzi API server you want to connect to. If you're using Uffizzi Cloud, accept the default value, otherwise enter the URL of your Uffizzi API server.

uffizzi config
# ...
# Server (


The account you use to log in to Uffizzi. For example, if you login to Uffizzi via GitHub or GitLab, select your personal or organizational/group account

uffizzi config
# ...
# Select an account: (Press ↑/↓/←/→ arrow to move and Enter to select)
# ‣ jdoe
#   Acme Inc


Create a new project or select an existing project.

uffizzi config
# ...
# Select a project: (Press ↑/↓/←/→ arrow to move and Enter to select)
# ‣ default
#   My Project
#   Create a new project

You can also pass the Uffizzi-wide flag --project to any CLI command to change the target project on the fly:

uffizzi cluster create --project some-other-project

Next Steps

Once your CLI is configured, take a look at the list of CLI commands and their options.