> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and log in

> Install adside, log in with your browser and choose a workspace.

`adside` brings Adside to your terminal: campaigns, creatives, assets and reporting across your ad accounts, for you or for an AI agent working with you.

## Install

```bash theme={null}
npm install -g adside
```

It needs Node.js 22 or later, on macOS, Linux or Windows.

## Log in

```bash theme={null}
adside login
```

Your browser opens Adside. Approve "Adside CLI" once, and the terminal is logged in.

On a computer without a browser, over SSH for example, run `adside login --no-browser`. Open the link on any device and paste the code it shows.

## Choose a workspace

With several workspaces, `adside login` asks which one commands use by default. Change it at any time:

```bash theme={null}
adside use                # list your workspaces
adside use "Acme"         # by name or ID
```

Check where you are:

```bash theme={null}
adside whoami
```

## Your login

The login is kept in your operating system's credential store: the macOS Keychain, the Windows Credential Manager or the Secret Service on Linux. Where there is none, it is kept in `~/.config/adside/credentials.json`, readable only by you.

It stays valid while you use it at least once every 30 days.

* `adside logout` ends it on this computer.
* In Adside, **Settings**, then **Sessions**, lists every computer where you are logged in. Revoke one, and commands there stop working within 15 minutes.

To keep logins apart, save one under a name with `adside login --profile <name>`, and select it with the `ADSIDE_PROFILE` environment variable.

## In CI or on a server

Set `ADSIDE_API_KEY` to a [personal API key](https://docs.adside.ai/authentication.md#personal-api-keys) instead of logging in. A key in `ADSIDE_API_KEY` comes before a stored login, and `adside whoami` shows which one is in use. A key acts as the person who created it, with their permissions.

## Next

* [Using commands](https://docs.adside.ai/cli/commands.md)
* [Command reference](https://docs.adside.ai/cli/reference/account.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.