Skip to main content
This guide will walk you through getting started with Nuon.
You must already have signed up for the trial which creates an organization for your apps before you can complete this guide. Please signup here.

​
Install the CLI

brew install nuonco/tap/nuon
If you are not using Homebrew, refer to our CLI documentation for other installation options.
The Nuon CLI changes frequently. To ensure you have the latest version, run brew upgrade nuonco/tap/nuon regularly. If you encounter any CLI command errors, please check you are using the latest version.

​
Authenticate

Once you have installed the Nuon CLI, log in. 
nuon auth login
Follow the prompts in the browser and log in using a Google account. Once you’ve logged in, you can verify your API token with the nuon orgs api-token command. You should also now have a config file at ~/.nuon. Values saved to this file will be used as CLI flag defaults.

​
Select Your Organization

Now that you are logged in, you can select your organization to start using it. 
nuon orgs select
Confirm you have selected the correct organization. 
nuon orgs current

​
Connect Your GitHub Account

To deploy code from private repositories, you will need to connect to your GitHub account or organization.
This step is not required if you are only using public repositories.
nuon orgs connect-github
Confirm the repository is connected. 
nuon orgs list-vcs-connections
Alternatively, you can connect your GitHub account via the Nuon web dashboard. Click your organization name in the top left, then click Add next to GitHub Connections.

​
Create an App

Now that you are set up, the next step is to configure and deploy an app.