Se vuoi mantenere le richieste all'interno della tua infrastruttura, puoi eseguire un'istanza privata con l'immagine ufficiale su Docker Hub. È multipiattaforma e supporta le architetture amd64 e arm64.

Avvio rapido

Il modo più veloce per iniziare:

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

Questo avvia Frankfurter sulla porta 8080 con un database temporaneo. Alcuni endpoint potrebbero restituire risposte vuote fino al completamento del caricamento iniziale.

Produzione

Per gli ambienti di produzione, monta un volume per mantenere 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 è temporaneo e viene ricostruito a ogni riavvio.

Il flag --pull always garantisce che Docker scarichi 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 di Bank Al-Maghrib. Registrati su apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

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

BCCH_USER e BCCH_PASS

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

BOT_API_KEY

Dati di 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.