# Fichiers

> files ls, cat, get, put, mkdir, rm, mv

Les fichiers d'un service vivent dans `/home/container`, et c'est cette racine que
`ark files` montre. Les chemins s'écrivent depuis elle : `/server.properties`,
`/plugins/EssentialsX.jar`.

## ark files ls

```bash
ark files ls survie-2026
ark files ls survie-2026 /plugins
ark files ls survie-2026 /plugins --json
```

```
plugins/      —       755  2026-09-15 11:54
world/        —       755  2026-09-16 09:02
server.jar    48.2 Mo 644  2026-09-15 11:54
server.properties 1.2 ko 644  2026-09-16 14:20
```

Sans chemin, la racine.

## ark files cat

Affiche un fichier sans le télécharger.

```bash
ark files cat survie-2026 /server.properties
```

## ark files get

Le récupère chez toi.

```bash
ark files get survie-2026 /logs/latest.log
ark files get survie-2026 /logs/latest.log ./survie.log
```

Sans destination, le fichier prend son nom d'origine dans le dossier courant.

## ark files put

L'envoie.

```bash
ark files put survie-2026 ./server.properties /server.properties
ark files put survie-2026 ./plugins/EssentialsX.jar /plugins/EssentialsX.jar
```

```
- envoi de ./server.properties vers /server.properties
ok /server.properties est écrit
```

<Note>
  `ark files put` écrase sans demander. Un `ark files get` avant, et tu as ta copie de
  secours.
</Note>

## ark files mkdir

```bash
ark files mkdir survie-2026 /plugins/config
```

## ark files rm

```bash
ark files rm survie-2026 /logs/2026-09-01.log.gz
ark files rm survie-2026 /logs/a.log /logs/b.log /plugins/vieux.jar
```

Plusieurs chemins à la fois sont acceptés, même dans des dossiers différents : le CLI
les regroupe par dossier avant d'envoyer.

## ark files mv

Renomme sur place.

```bash
ark files mv survie-2026 /server.properties /server.properties.bak
```

Le déplacement d'un dossier vers un autre n'est pas encore possible :

```
x Le déplacement entre dossiers n'est pas encore possible.
  Renomme sur place, ou passe par `ark sftp`.
```

## Sans nommer le service

Un chemin commence par `/`, un nom de service jamais : avec un service choisi par
`ark use`, tu peux l'omettre.

```bash
ark use survie-2026
ark files ls /plugins
ark files get /logs/latest.log
```

## Quand passer par SFTP

`ark files` est fait pour les allers-retours rapides : lire un fichier de
configuration, récupérer un journal, poser un plugin. Pour un dossier entier, une
carte de plusieurs gigaoctets ou une synchronisation, prends
[`ark sftp`](/cli/sftp) et un vrai client.

## La limite de taille

Un fichier envoyé par `ark files put` est plafonné à 2 Mo — c'est la limite de
l'éditeur côté API. Au-delà, SFTP.