İstekleri kendi altyapında tutmak istiyorsan Docker Hub üzerindeki resmi image ile kendi sunucunu çalıştırabilirsin. Image çok platformlu; hem amd64 hem de arm64 mimarisini destekler.

Hızlı başlangıç

Başlamanın en hızlı yolu:

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

Bu komut Frankfurter'i 8080 portunda, geçici bir veritabanıyla başlatır. İlk backfill tamamlanana kadar bazı endpoint'ler boş veri döndürebilir.

Production

Production ortamında, container yeniden başladığında SQLite veritabanı kaybolmasın diye bir volume bağla:

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

Volume bağlamazsan veritabanı geçici olur ve her yeniden başlatmada sıfırdan oluşturulur.

--pull always ile Docker her çalıştırmada en son sürümü çeker.

API anahtarları

Bazı veri kaynakları API anahtarı ister. Hepsi ücretsiz ve isteğe bağlı.

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 verileri. Kayıt adresi: apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

Banco de México verileri. Kayıt adresi: banxico.org.mx.

BCCH_USER ve BCCH_PASS

Banco Central de Chile verileri. Kayıt adresi: bcentral.cl.

BOT_API_KEY

Bank of Thailand verileri. Kayıt adresi: gateway.api.bot.or.th.

FRED_API_KEY

Federal Reserve verileri. Kayıt adresi: fred.stlouisfed.org.

TCMB_API_KEY

Türkiye Cumhuriyet Merkez Bankası verileri. Kayıt adresi: evds3.tcmb.gov.tr.