自社インフラ内でリクエストを処理したい場合は、Docker Hubの公式イメージを使用して独自インスタンスを実行できます。イメージはamd64およびarm64に対応しています。

クイックスタート

最も手軽な起動方法:

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

これによりFrankfurterがポート8080でメモリ内データベースを使用して起動します。初期同期が完了するまで、一部のエンドポイントは空の結果を返す場合があります。

本番環境

本番環境ではボリュームをマウントし、コンテナの再起動後もSQLiteデータベースが維持されるようにします:

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

ボリュームがない場合、データベースは一時的なものとなり、再起動ごとに再構築されます。

--pull alwaysを指定すると、Dockerは起動時に常に最新のイメージを取得します。

APIキー

一部のデータソースはAPIキーを必要とします。キーは無料で、設定は任意です。

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

モロッコ中央銀行（Bank Al-Maghrib）データ。登録先: apihelpdesk.centralbankofmorocco.ma

BANXICO_API_KEY

メキシコ銀行（Banco de México）データ。登録先: banxico.org.mx

BCCH_USER および BCCH_PASS

チリ中央銀行（Banco Central de Chile）データ。登録先: bcentral.cl

BOT_API_KEY

タイ銀行（Bank of Thailand）データ。登録先: gateway.api.bot.or.th

FRED_API_KEY

セントルイス連邦準備銀行（Federal Reserve）データ。登録先: fred.stlouisfed.org

TCMB_API_KEY

トルコ共和国中央銀行データ。登録先: evds3.tcmb.gov.tr