btcpayserver/btcpayserver-docker

O que é?

Recursos principais

• 01Gera uma stack do Docker Compose a partir de variáveis de ambiente e fragmentos opcionais.
• 02Inclui BTCPay Server, PostgreSQL, NBXplorer e Bitcoin Core.
• 03Configura o Nginx com certificados HTTPS automáticos quando um domínio está configurado.
• 04Oferece suporte a serviços ocultos do Tor e a implementações opcionais de Lightning.
• 05Instala utilitários de linha de comando e configura a inicialização da stack junto com o sistema.

Casos de uso

• Hospedar em um VPS um processador de pagamentos em Bitcoin próprio para uma loja online.
• Implantar o BTCPay Server em um provedor de nuvem usando um script de instalação guiada.
• Adicionar suporte opcional a Lightning ou altcoins a um deploy existente do BTCPay.

Início rápido

1. 1

   Configure as variáveis de ambiente do seu domínio, da rede e dos componentes

   export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs"
2. 2

   Clone o repositório

   git clone https://github.com/btcpayserver/btcpayserver-docker
3. 3

   Execute o script de configuração para gerar e iniciar a stack

   . ./btcpay-setup.sh -i
4. 4

   Abra seu domínio em um navegador e cadastre a primeira conta de administrador

Antes de usar

• !O HTTPS automático requer um domínio apontado para o servidor e as portas 80 e 443 abertas.
• !A sincronização inicial do Bitcoin pode demorar bastante e exige recursos consideráveis do servidor.

Em coleções

Tópicos

Perguntas frequentes

O que é btcpayserver-docker?

Deploy oficial do BTCPay Server com Docker Compose, que gera e executa a stack completa a partir de variáveis de ambiente. Este repositório oferece o deploy oficial do BTCPay Server, um processador de pagamentos em Bitcoin auto-hospedado. Um script de configuração transforma um pequeno conjunto de variáveis de ambiente e fragmentos opcionais em uma stack do Docker Compose; em seguida, instala os utilitários de linha de comando, configura a inicialização da stack junto com o sistema e inicia os serviços.

btcpayserver-docker é gratuito? Qual é a licença?

btcpayserver-docker é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

btcpayserver-docker ainda é mantido?

Manutenção ativa. O último commit de btcpayserver-docker foi em 6 de nov. de 2026.

Para que posso usar btcpayserver-docker?

Hospedar em um VPS um processador de pagamentos em Bitcoin próprio para uma loja online. Implantar o BTCPay Server em um provedor de nuvem usando um script de instalação guiada. Adicionar suporte opcional a Lightning ou altcoins a um deploy existente do BTCPay.

Como instalar btcpayserver-docker?

Configure as variáveis de ambiente do seu domínio, da rede e dos componentes: export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs" Clone o repositório: git clone https://github.com/btcpayserver/btcpayserver-docker Execute o script de configuração para gerar e iniciar a stack: . ./btcpay-setup.sh -i Abra seu domínio em um navegador e cadastre a primeira conta de administrador

Onde consigo btcpayserver-docker?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/btcpayserver/btcpayserver-docker