Skip to content

Install/Configure CLI

The Nullstone CLI is a utility that allows users to manage Nullstone from a terminal:

  1. Perform code deployments or infra provisions
  2. Retrieve data from Nullstone
  3. Manage Nullstone objects
  4. Generate, publish, and manage infrastructure modules

This utility is an open-source project that has been pre-packaged for any platform. Refer to the OS-specific instructions in this section to install for your machine.

Install

Install the pre-compiled binary based on your system.

Homebrew (Mac)

shell
brew tap nullstone-io/nullstone https://github.com/nullstone-io/nullstone.git
brew install nullstone
brew tap nullstone-io/nullstone https://github.com/nullstone-io/nullstone.git
brew install nullstone

As we release updates, you only need to run the following command to upgrade the CLI.

shell
brew upgrade nullstone
brew upgrade nullstone

Scoop (Windows)

shell
scoop bucket add nullstone https://github.com/nullstone-io/nullstone.git
scoop install nullstone
scoop bucket add nullstone https://github.com/nullstone-io/nullstone.git
scoop install nullstone

As we release updates, you only need to run the following command to upgrade the CLI.

shell
scoop update nullstone
scoop update nullstone

Go Install (Any Platform)

shell
go install gopkg.in/nullstone-io/nullstone.v0/nullstone@latest
go install gopkg.in/nullstone-io/nullstone.v0/nullstone@latest

Configure CLI

To configure your CLI, you must configure your CLI with an API Key created in Nullstone.

Create API Key

Visit https://app.nullstone.io/profile and click "New API Key". Typically, the name of the API Key refers to the machine/system where the API Key is stored and used.

Create API Key

Run the following command to configure your CLI with the generated API Key.

shell
nullstone configure --api-key=<api-key>
nullstone configure --api-key=<api-key>

Set Default Organization

The Nullstone CLI scopes requests to Nullstone servers based on a default organization that you will configure on your machine. To configure this default organization, run the following command. The <org-name> refers to your organization's name in Nullstone that has no spaces or uppercase characters. This setting is required for most CLI commands.

shell
nullstone set-org <org-name>
nullstone set-org <org-name>

Alternatively, you can use the global --org flag to specify an organization per command.

shell
nullstone --org=<org-name> deploy <app-name> <env-name>
nullstone --org=<org-name> deploy <app-name> <env-name>