Skip to content

alis authorise

Configure a product's local define and build repositories to use the auto-refreshing Alis git credential helper, and refresh the short-lived Go, npm, Docker and Dart package credentials.

Synopsis

alis authorise [<org>.<product>] [flags]

Aliases: authorise, a, authorize.

Description

Run it once for existing or externally cloned repos, or to repair a missing helper or a stale http.extraHeader after git authentication fails. Do not run it before every git operation: the configured helper refreshes tokens on demand. Package commands (alis packages install|upgrade|add) refresh their own credentials.

The product may be omitted when the working directory is inside ~/alis.build/<org>/build/<product>.

Flags

No flags beyond the global flags.

Examples

Shell
alis authorise acme.shop --json
alis a --json

Exit codes

Exit code 4 means you are signed out: run alis login instead, then retry.

When to run it

  • A repository predates the Alis git credential helper, or was cloned outside the CLI.
  • Git prompts for a password or fails authentication.
  • You want to refresh package credentials without running a package command.