> For the complete documentation index, see [llms.txt](https://docs.ipcheck.ing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipcheck.ing/developer/fr/getting-started/quickstart.md).

# guide de démarrage rapide

Faites fonctionner votre propre instance MyIP avec une seule commande Docker.

Le moyen le plus rapide d’exécuter MyIP est l’image Docker préconstruite. Vous avez besoin de Docker et d’un compte MaxMind GeoLite2 gratuit.

{% stepper %}
{% step %}

#### Obtenir les identifiants MaxMind

MyIP utilise les **GeoLite2** bases de données gratuites pour la géolocalisation IP et les recherches ASN. Inscrivez-vous sur [maxmind.com/en/geolite2/signup](https://www.maxmind.com/en/geolite2/signup), puis générez une clé de licence depuis la page **Gérer les clés de licence** .

Guide complet : [Configuration de MaxMind](/developer/fr/getting-started/maxmind-setup.md).
{% endstep %}

{% step %}

#### Lancer le conteneur

{% code title="docker run" %}

```bash
docker run -d \
  -p 18966:18966 \
  -e MAXMIND_ACCOUNT_ID="your-account-id" \
  -e MAXMIND_LICENSE_KEY="your-license-key" \
  -e DATASET_AUTO_UPDATE="true" \
  --name myip \
  --restart always \
  jason5ng32/myip:latest
```

{% endcode %}
{% endstep %}

{% step %}

#### Ouvrir l’application

Accédez à <http://localhost:18966>.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Au premier démarrage, les bases de données GeoLite2 sont téléchargées.** L’application est accessible immédiatement ; le téléchargement s’exécute en arrière-plan et abandonne après 5 minutes, donc de mauvais identifiants ne bloquent jamais le démarrage. Tant qu’il n’est pas terminé, les requêtes MaxMind répondent `503` et les badges de pays restent vides. Suivez la progression avec `docker logs -f myip` — vous cherchez la ligne `📦 Bases de données MaxMind chargées`.
{% endhint %}

{% hint style="warning" %}
**`localhost` fonctionne immédiatement. Un vrai domaine, non.** Le backend rejette toute `/api/*` requête dont le `Referer` nom d’hôte n’est pas `localhost` et n’est pas répertorié dans `ALLOWED_DOMAINS`. Avant de mettre MyIP sur un domaine, lisez [Proxy inverse et domaines](/developer/fr/getting-started/reverse-proxy-and-domains.md).
{% endhint %}

{% hint style="info" %}
**Modifier MyIP ?** MyIP est sous licence [AGPL-3.0](https://github.com/jason5ng32/MyIP/blob/main/LICENSE). Le faire fonctionner sans modification ne nécessite rien de plus. Si vous le modifiez et le laissez utilisé par d’autres personnes, vous devez leur fournir votre code source modifié sous la même licence.
{% endhint %}

## Étapes suivantes

* [Déployer avec Docker](/developer/fr/getting-started/deploy-with-docker.md) — Compose, mises à niveau, mappage des ports, emplacement des données
* [Déployer avec Node.js](/developer/fr/getting-started/deploy-with-nodejs.md) — compiler depuis les sources, exécuter sous pm2
* [Clés API facultatives](/developer/fr/configuration/optional-api-keys.md) — sources de données IP supplémentaires, cartes, outils ASN
* [Variables d’environnement](/developer/fr/reference/environment-variables.md) — la liste complète


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ipcheck.ing/developer/fr/getting-started/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.