Note: If you are looking for configuration on a per-deployment basis, read our deployment configuration documentation.

Using the following files and configuration options, you can configure Now CLI under your system user.

There are two global configuration files: config.json and auth.json. By default, these files are held in a directory named .now within the user's home directory. For example on Unix based systems they will be found at ~/.now/*.json.


This file is used for global configuration of ZEIT Now deployments. Now CLI uses this file as a way to co-ordinate how deployments should be treated, consistently.

The first option is a single _ that gives a description to the file, if a user should find themselves looking through it without context.

The following options are all of the options that can be used by users to configure their Now deployments globally on their system for that user profile:


Type: String.

Valid values: A team ID.

This option tells Now CLI which context is currently active. If this property exists and contains a team ID, that team is used as the scope for deployments, otherwise if this property does not exist, the user's personal account is used.

  "currentTeam": "team_ofwUZockJlL53hINUGCc1ONW"


Type: String.

Valid values: An API Origin URL.

This option selects which API Origin Now CLI should use when performing an action requiring the API.

  "api": ""


Type: Boolean.

Valid values: true (default), false.

This option defines whether Now CLI should collect anonymous metrics about which commands are invoked the most, how long they take to run, and which errors customers are running into.

  "collectMetrics": true


This file should not be edited manually. It exists to contain the authentication information for the ZEIT Now clients.

In the case that you are uploading your global configuration setup to a potentially insecure destination, we highly recommend ensuring that this file will not be uploaded, as it allows an attacker to gain access to your provider accounts.