Launch Apollo Studio

Configuring Rover

Authenticating with Apollo Studio

1. Obtain an API key

All Rover commands that communicate with Apollo Studio require an API key to do so. Studio supports two types of API keys: personal API keys and graph API keys.

  • On your local development machine, use a personal API key.
  • In shared environments like CI, use a graph API key.

Learn how to obtain an API key

2. Provide the API key to Rover

You can provide your API key to Rover either via a Rover command (recommended for local development) or by setting an environment variable (recommended for automation and CI).

If you provide an API key via both methods, the environment variable takes precedence.

Via the auth command

You can provide your API key to Rover by running the following command:

rover config auth

This method is recommended for local development. If you have more than one API key you want to use with Rover, you can assign those keys to different configuration profiles.

The auth command is interactive to prevent your API key from appearing in your terminal command history. Because it's interactive, we recommend using an environment variable in automated environments such as CI.

With an environment variable

You can provide your API key to Rover by setting it as the value of the APOLLO_KEY environment variable. This method is recommended for automated environments such as CI.

Configuration profiles

You can create multiple configuration profiles in Rover. Each configuration profile has its own associated API key, so you can use different configuration profiles when interacting with different graphs.

To specify which configuration profile to use for a particular command, use the --profile flag:

rover graph check my-company@prod --profile work

If you don't specify a configuration profile for a command, Rover uses the default profile (named default).

To view all commands for working with configuration profiles, run the following command:

rover config --help


Rover supports the following levels of logging, in descending order of severity:

  • error
  • warn
  • info
  • debug
  • trace

By default, Rover logs error, warn, and info messages. You can configure this behavior for a command by setting its minimum log level with the --log flag:

rover graph check my-graph@prod --schema ./schema.graphql --log debug

If Rover log messages are unhelpful or unclear, please leave us feedback in an issue on GitHub!

Setting config storage location

Rover stores your configuration in a local file and uses it when making requests. By default, this file is stored in your operating system's default configuration directory, in a file named .sensitive.

You can override the location of this configuration file by setting the APOLLO_CONFIG_HOME environment variable. This can be useful for CI systems that don't give you access to default operating system directories.

# Stores config in ./myspecialconfig/rover.toml

Git context

Rover sends non-confidential information about your Git environment to Apollo Studio when you run a check or publish command. This information is displayed in relevant views of the Studio UI, making it easier to track down where schema changes were proposed or published:

Checks info in Apollo Studio

This Git information includes:

  • The remote URL of your Git repository (stripped of any usernames/passwords)
  • The current commit's SHA
  • The committer of the current SHA
  • The current branch name

To see these values, run any check or publish command with the --log trace option.


None of this information should be sensitive, but if you want to override these values, you can set the APOLLO_VCS_REMOTE_URL, APOLLO_VCS_BRANCH, APOLLO_VCS_COMMIT, and APOLLO_VCS_AUTHOR environment variables.

Non-Git version control

If you use a version control system besides Git, you can use the environment variables described in Git context to set similar information relevant to your VCS tool,

Currently, only Git is fully supported by Apollo Studio.

Supported environment variables

You can configure Rover's behavior by setting the environment variables listed below.

If present, an environment variable's value takes precedence over all other methods of configuring the associated behavior.

APOLLO_HOMEThe path to the parent directory of Rover's binary. The default value is your operating system's default home directory. Rover will install itself in a folder called .rover inside the directory specified.
APOLLO_CONFIG_HOMEThe path where Rover's configuration is stored. The default value is your operating system's default configuration directory.
APOLLO_KEYThe API key that Rover should use to authenticate with Apollo Studio.
APOLLO_TELEMETRY_DISABLEDSet to 1 if you don't want Rover to collect anonymous usage data.
APOLLO_VCS_REMOTE_URLThe URL of your project's remote repository. See Git context.
APOLLO_VCS_BRANCHThe name of the version-controlled branch. See Git context.
APOLLO_VCS_COMMITThe long identifier (SHA in Git) of the commit. See Git context.
APOLLO_VCS_AUTHORThe name and email of a commit's author (e.g., Jane Doe <jane@example.com>). See Git context.
Edit on GitHub