# Documentation

> Tes serveurs de jeu, tes applications, tes instances et ton stockage — depuis l'espace client, ton terminal, ou ton propre outil.

<div className="relative overflow-hidden border-b border-gray-200 dark:border-white/10">
  <div className="absolute inset-0 -z-10 bg-[radial-gradient(70%_60%_at_50%_-10%,rgba(255,69,0,0.20),transparent_70%)]" />

  <div className="mx-auto max-w-3xl px-6 pt-24 pb-14 text-center">
    <p className="text-sm font-medium uppercase tracking-[0.18em] text-[#ff4500]">Documentation</p>
    <h1 className="mt-4 text-5xl font-semibold tracking-tight">Tout ce qu'Arkya sait faire</h1>
    <p className="mt-6 text-lg leading-relaxed text-gray-500 dark:text-gray-400">
      Un serveur Minecraft qui répond en deux minutes, une image Docker en production, une
      base de données que personne d'autre ne joint. Trois façons de le piloter, la même
      vérité derrière.
    </p>

    <div className="mt-8 flex flex-wrap items-center justify-center gap-3">
      <a href="/espace-client" className="rounded-lg bg-[#ff4500] px-5 py-2.5 text-sm font-semibold text-white no-underline hover:brightness-110">
        Visiter l'espace client
      </a>
      <a href="/commencer/installation" className="rounded-lg border border-gray-300 px-5 py-2.5 text-sm font-semibold no-underline hover:border-gray-400 dark:border-white/15 dark:hover:border-white/30">
        Installer le CLI
      </a>
    </div>
  </div>
</div>

<div className="mx-auto max-w-6xl px-6 py-16">

<h2 className="mb-2 text-2xl font-semibold tracking-tight">Trois portes, une seule maison</h2>
<p className="mb-8 max-w-2xl text-gray-500 dark:text-gray-400">
  Ce que tu fais dans un onglet, tu le retrouves dans l'autre. Le CLI et l'API n'ont aucun
  privilège que l'espace client n'aurait pas — ils appellent les mêmes routes.
</p>

<CardGroup cols={3}>
  <Card title="L'espace client" icon="browser" href="/espace-client">
    Le canevas d'un projet, le panneau d'un service, la dépense qui monte. Pour voir, et
    pour faire à la main.
  </Card>
  <Card title="Le terminal" icon="terminal" href="/cli">
    La commande `ark`. Pour déployer, scripter, et ne pas quitter son éditeur.
  </Card>
  <Card title="L'API HTTP" icon="code" href="/api">
    Les mêmes routes, avec un jeton. Pour brancher ton propre outillage.
  </Card>
</CardGroup>

<h2 className="mt-20 mb-2 text-2xl font-semibold tracking-tight">Premiers pas</h2>
<p className="mb-8 max-w-2xl text-gray-500 dark:text-gray-400">
  Un compte tout neuf, et l'envie que quelque chose tourne avant la fin du café.
</p>

<Steps>
  <Step title="Comprends ce que tu commandes">
    Six gammes, des états, des projets, une facturation à la minute. Trois pages courtes
    pour ne pas se tromper de produit : [les gammes](/comprendre/gammes),
    [les projets](/comprendre/projets), [la facturation](/comprendre/facturation).
  </Step>
  <Step title="Pose ton premier service">
    Depuis le canevas, en quatre clics — ou depuis le terminal si tu préfères :
    [ton premier service](/commencer/premier-service).
  </Step>
  <Step title="Branche le reste dessus">
    Une base, une application, un nom d'hôte interne. Le cas le plus courant, de bout en
    bout : [brancher une application sur sa base](/espace-client/cas/brancher-une-app-sur-sa-base).
  </Step>
</Steps>

<h2 className="mt-20 mb-2 text-2xl font-semibold tracking-tight">Ce que tu peux héberger</h2>
<p className="mb-8 max-w-2xl text-gray-500 dark:text-gray-400">
  Six gammes qui ne font pas la même chose, et n'acceptent donc pas les mêmes gestes : un
  serveur de jeu a une console et des sauvegardes, un bucket n'en a pas.
</p>

<CardGroup cols={3}>
  <Card title="AGS — Serveurs de jeu" icon="gamepad" href="/comprendre/gammes#ags-serveurs-de-jeu">
    Minecraft, Palworld, Rust. Console, fichiers, sauvegardes.
  </Card>
  <Card title="ACS — Applications" icon="boxes-stacked" href="/comprendre/gammes#acs-applications-conteneurisees">
    Ton image Docker, poussée depuis ton poste.
  </Card>
  <Card title="ADB — Bases de données" icon="database" href="/espace-client/donnees">
    Postgres, MySQL, Redis. Fermées sur Internet par défaut.
  </Card>
  <Card title="ACI — Instances" icon="server" href="/comprendre/gammes#aci-instances">
    Un Linux en conteneur, avec ses instantanés.
  </Card>
  <Card title="AVM — Machines virtuelles" icon="microchip" href="/comprendre/gammes#avm-machines-virtuelles">
    Ton propre noyau, ton propre système.
  </Card>
  <Card title="AOS — Stockage objet" icon="box-archive" href="/comprendre/gammes#aos-stockage-objet">
    Des fichiers joignables en S3.
  </Card>
</CardGroup>

<h2 className="mt-20 mb-2 text-2xl font-semibold tracking-tight">Les guides qu'on lit le plus</h2>

<CardGroup cols={2}>
  <Card title="Monter un serveur Minecraft" icon="cube" href="/guides/serveur-minecraft">
    De la commande à la première connexion d'un joueur.
  </Card>
  <Card title="Déployer une image Docker" icon="docker" href="/guides/deployer-une-application">
    Ce que `ark deploy` construit, pousse, et met en service.
  </Card>
  <Card title="Fermer un service sur Internet" icon="lock" href="/espace-client/cas/fermer-sur-internet">
    Le garder joignable par ses voisins, et par personne d'autre.
  </Card>
  <Card title="Faire grandir un service" icon="arrow-up-right-dots" href="/espace-client/cas/faire-grandir">
    Plus de mémoire, plus de processeur, sans coupure.
  </Card>
  <Card title="Sauvegardes et instantanés" icon="clock-rotate-left" href="/espace-client/sauvegardes">
    Deux filets qui ne rattrapent pas la même chute.
  </Card>
  <Card title="Suivre ce que ça coûte" icon="chart-column" href="/espace-client/cas/suivre-la-depense">
    Lire le mois en cours, prévoir la suite, ne pas se faire surprendre.
  </Card>
</CardGroup>

<h2 className="mt-20 mb-2 text-2xl font-semibold tracking-tight">Trente secondes de terminal</h2>

```bash
# relier ce poste à ton compte
ark login

# voir ce que tu héberges, toutes gammes confondues
ark ls

# s'attacher à la console d'un serveur et lui parler
ark console mon-serveur
> say Le serveur redémarre dans 5 minutes
```

<Note>
  La commande `ark` parle à la même API que l'espace client. Ce que tu fais dans un
  onglet, tu le retrouves dans l'autre — il n'y a pas deux vérités.
</Note>

</div>