Se você quer manter as requisições dentro da sua própria infraestrutura, pode rodar uma instância privada com a imagem oficial do Docker Hub. A imagem é multiplataforma e roda em amd64 e arm64.

Início rápido

O jeito mais rápido de começar:

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

Isso sobe o Frankfurter na porta 8080 com um banco de dados efêmero. Alguns endpoints podem retornar dados vazios até a carga inicial terminar.

Produção

Em produção, monte um volume para persistir o banco SQLite entre reinícios do container:

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

Sem um volume montado, o banco é efêmero e é recriado a cada reinício.

A flag --pull always garante que o Docker baixe a imagem mais recente a cada execução.

Chaves de API

Algumas fontes de dados exigem chaves de API. Todas são gratuitas e opcionais.

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

Dados do Bank Al-Maghrib. Cadastre-se em apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

Dados do Banco de México. Cadastre-se em banxico.org.mx.

BCCH_USER e BCCH_PASS

Dados do Banco Central de Chile. Cadastre-se em bcentral.cl.

BOT_API_KEY

Dados do Bank of Thailand. Cadastre-se em gateway.api.bot.or.th.

FRED_API_KEY

Dados do Federal Reserve. Cadastre-se em fred.stlouisfed.org.

TCMB_API_KEY

Dados do Banco Central da Turquia. Cadastre-se em evds3.tcmb.gov.tr.