---
title: "alis authorise"
url: "https://docs.alisx.com/reference/cli/authorise/"
---
# 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

```bash
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](https://docs.alisx.com/reference/cli/index.md#global-flags).

## Examples

```bash title="Terminal"
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.