Si tu veux conserver les requêtes au sein de ta propre infrastructure, tu peux exécuter une instance privée avec l'image officielle sur Docker Hub. Elle est multi-plateforme et supporte les architectures amd64 et arm64.

Démarrage rapide

Le moyen le plus rapide de commencer :

docker run -d --init -p 8080:8080 lineofflight/frankfurter

Cela démarre Frankfurter sur le port 8080 avec une base de données éphémère. Certains endpoints peuvent renvoyer des données vides jusqu'à ce que le rattrapage initial soit terminé.

Production

En production, monte un volume pour conserver la base SQLite à travers les redémarrages du conteneur :

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter

Sans volume monté, la base est éphémère et se reconstruit à chaque redémarrage.

L'option --pull always garantit que Docker récupère la dernière image à chaque exécution.

Clés API

Certaines sources de données requièrent des clés API. Elles sont toutes gratuites et facultatives.

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -e BAM_API_KEY="your_key" \
  -e BANXICO_API_KEY="your_key" \
  -e BCCH_USER="your_email" \
  -e BCCH_PASS="your_password" \
  -e BOT_API_KEY="your_key" \
  -e FRED_API_KEY="your_key" \
  -e TCMB_API_KEY="your_key" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter

BAM_API_KEY

Données de Bank Al-Maghrib. Inscription sur apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

Données de Banco de México. Inscription sur banxico.org.mx.

BCCH_USER et BCCH_PASS

Données de Banco Central de Chile. Inscription sur bcentral.cl.

BOT_API_KEY

Données de Bank of Thailand. Inscription sur gateway.api.bot.or.th.

FRED_API_KEY

Données de la Réserve fédérale. Inscription sur fred.stlouisfed.org.

TCMB_API_KEY

Données de la Banque centrale de Turquie. Inscription sur evds3.tcmb.gov.tr.