# Installer le CLI

> Mettre la commande ark sur ton poste, et la relier à ton compte Arkya.

La commande `ark` pilote tout ce que tu héberges chez Arkya : serveurs de jeu,
applications, instances, stockage. Elle parle à la même API que l'espace client.

## Installer

<CodeGroup>

```bash npm
npm install -g @arkya/cli
```

```bash pnpm
pnpm add -g @arkya/cli
```

```bash Sans installation
npx @arkya/cli ls
```

</CodeGroup>

Il te faut **Node 22 ou plus récent** : le CLI se sert du client WebSocket livré
avec Node pour la console en direct, et il n'existe pas avant.

```bash
node --version
```

## Relier ton compte

```bash
ark login
```

La commande demande un jeton. Tu le crées depuis l'espace client, onglet
**Clés SSH & API** — voir [Créer un jeton](/commencer/jetons). Colle-le, et c'est fini :

```
- vérification du jeton
ok connecté en tant que toi@exemple.fr
identifiants dans /Users/toi/.arkya/credentials.json
```

Sans interaction, par exemple dans un script :

```bash
ark login --token ark_xxxxxxxxxxxxxxxxxxxx
# ou
ARKYA_TOKEN=ark_xxxxxxxxxxxxxxxxxxxx ark login
```

<Note>
  `ark login` connecte aussi Docker au registre Arkya, parce que `ark deploy` en a
  besoin. Si Docker n'est pas installé sur la machine, la connexion au registre est
  simplement ignorée avec un avertissement — passe `--no-docker` pour la sauter d'emblée.
</Note>

## Vérifier

```bash
ark whoami
ark ls
```

`ark ls` liste tout ton hébergement, gammes confondues :

```
nom                   gamme  état      adresse           taille                 par mois
survie-2026           AGS    en ligne  51.210.44.12:25565  4 vCPU · 8 Go · 80 Go  12.40 €
api-boutique          ACS    en ligne  api.exemple.fr      2 vCPU · 2 Go · 20 Go   6.10 €
runner-ci             ACI    arrêté    51.210.44.31        2 vCPU · 4 Go · 40 Go   7.30 €
```

## Où vivent tes identifiants

Le jeton est écrit dans `~/.arkya/credentials.json`, en lecture pour toi seul
(`0600`). Le service que tu as choisi par défaut avec [`ark use`](/cli/services#ark-use)
est gardé à côté, dans `~/.arkya/context.json`.

| Variable | Ce qu'elle change |
| --- | --- |
| `ARKYA_HOME` | Le dossier où sont écrits ces deux fichiers. Pratique pour isoler un runner d'intégration continue. |
| `ARKYA_TOKEN` | Le jeton employé par `ark login` quand tu ne veux pas le taper. |
| `NO_COLOR` | Coupe la couleur. Le CLI la coupe déjà tout seul quand la sortie n'est pas un terminal. |

Pour oublier ce poste :

```bash
ark logout
```

## Et maintenant

<CardGroup cols={2}>
  <Card title="Créer un jeton" icon="key" href="/commencer/jetons">
    Complet ou registre : ce que chacun autorise.
  </Card>
  <Card title="Ton premier service" icon="rocket" href="/commencer/premier-service">
    Commander, démarrer, ouvrir la console.
  </Card>
</CardGroup>