Se vuoi che le richieste restino nella tua infrastruttura, puoi eseguire un'istanza privata con l'immagine ufficiale su Docker Hub. L'immagine è multi-platform e supporta sia amd64 sia arm64.

Avvio rapido

Il modo più veloce per iniziare:

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

Così avvii Frankfurter sulla porta 8080 con un database effimero. Alcuni endpoint possono restituire dati vuoti finché il backfill iniziale non è completo.

Produzione

In produzione, monta un volume per rendere persistente il database SQLite tra i riavvii del container:

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

Senza un volume montato, il database è effimero e viene ricostruito a ogni riavvio.

Con il flag --pull always, Docker scarica l'immagine più recente a ogni avvio.

Chiavi API

Alcune fonti richiedono chiavi API. Sono tutte gratuite e facoltative.

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

Dati della Bank Al-Maghrib. Registrati su apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

Dati del Banco de México. Registrati su banxico.org.mx.

BCCH_USER e BCCH_PASS

Dati del Banco Central de Chile. Registrati su bcentral.cl.

BOT_API_KEY

Dati della Bank of Thailand. Registrati su gateway.api.bot.or.th.

FRED_API_KEY

Dati della Federal Reserve. Registrati su fred.stlouisfed.org.

TCMB_API_KEY

Dati della Banca centrale della Turchia. Registrati su evds3.tcmb.gov.tr.