Un procesador de pagos con Bitcoin, gratuito, de código abierto y autohospedado, que permite a los comercios aceptar Bitcoin directamente y sin intermediarios.
btcpayserver/btcpayserver-docker
Despliegue oficial con Docker Compose que genera y ejecuta una pila completa de BTCPay Server a partir de variables de entorno.
Alternativa open source a:BitPay
- Estrellas
- 762
- Forks
- 440
- Issues abiertos
- 126
- Último commit
- hace 16 horas
¿Qué es?
Este repositorio ofrece el despliegue oficial de BTCPay Server con Docker, un procesador de pagos con Bitcoin autogestionado. Un script de configuración convierte un conjunto reducido de variables de entorno y fragmentos opcionales en una pila de Docker Compose; después instala las utilidades de línea de comandos, configura la pila para que se inicie al arrancar el sistema y pone en marcha los servicios.
El despliegue estándar de Bitcoin incluye BTCPay Server, PostgreSQL, NBXplorer, Bitcoin Core y Nginx con certificados HTTPS automáticos, además de servicios ocultos de Tor. Las implementaciones de Lightning, las criptomonedas adicionales y otros servicios son opcionales y se habilitan mediante la configuración.
El proyecto está dirigido a administradores que quieren ejecutar y mantener su propia instancia de BTCPay en un VPS. Junto con los scripts, se proporcionan guías específicas para proveedores, recomendaciones sobre los recursos del servidor y documentación sobre actualizaciones, copias de seguridad y personalización.
Funciones clave
- 01Genera una pila de Docker Compose a partir de variables de entorno y fragmentos opcionales.
- 02Incluye BTCPay Server, PostgreSQL, NBXplorer y Bitcoin Core.
- 03Configura Nginx con certificados HTTPS automáticos cuando se especifica un dominio.
- 04Admite servicios ocultos de Tor e implementaciones opcionales de Lightning.
- 05Instala utilidades de línea de comandos y configura la pila para que se inicie al arrancar el sistema.
Casos de uso
- Alojar en un VPS un procesador de pagos con Bitcoin autogestionado para una tienda en línea.
- Desplegar BTCPay Server en un proveedor de nube mediante un script de instalación guiado.
- Añadir compatibilidad opcional con Lightning o altcoins a una implementación existente de BTCPay.
Inicio rápido
- 1
Configura las variables de entorno de tu dominio, red y 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
Clona el repositorio
git clone https://github.com/btcpayserver/btcpayserver-docker - 3
Ejecuta el script de configuración para generar e iniciar el stack
. ./btcpay-setup.sh -i - 4
Abre tu dominio en un navegador y registra la primera cuenta de administrador
Antes de usarlo
- Para usar HTTPS automático, necesitas un dominio que apunte al servidor y tener abiertos los puertos 80 y 443.
- La sincronización inicial de Bitcoin puede tardar mucho y requiere recursos considerables del servidor.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es btcpayserver-docker?
- Despliegue oficial con Docker Compose que genera y ejecuta una pila completa de BTCPay Server a partir de variables de entorno. Este repositorio ofrece el despliegue oficial de BTCPay Server con Docker, un procesador de pagos con Bitcoin autogestionado. Un script de configuración convierte un conjunto reducido de variables de entorno y fragmentos opcionales en una pila de Docker Compose; después instala las utilidades de línea de comandos, configura la pila para que se inicie al arrancar el sistema y pone en marcha los servicios.
- ¿btcpayserver-docker es gratuito? ¿Qué licencia tiene?
- btcpayserver-docker es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿btcpayserver-docker sigue mantenido?
- Mantenimiento activo. El último commit de btcpayserver-docker fue el 6 nov 2026.
- ¿Para qué puedo usar btcpayserver-docker?
- Alojar en un VPS un procesador de pagos con Bitcoin autogestionado para una tienda en línea. Desplegar BTCPay Server en un proveedor de nube mediante un script de instalación guiado. Añadir compatibilidad opcional con Lightning o altcoins a una implementación existente de BTCPay.
- ¿Cómo se instala btcpayserver-docker?
- Configura las variables de entorno de tu dominio, red y 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" Clona el repositorio: git clone https://github.com/btcpayserver/btcpayserver-docker Ejecuta el script de configuración para generar e iniciar el stack: . ./btcpay-setup.sh -i Abre tu dominio en un navegador y registra la primera cuenta de administrador
- ¿Dónde consigo btcpayserver-docker?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/btcpayserver/btcpayserver-docker
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Implementación en Go de un nodo de Lightning Network que gestiona canales, enruta pagos y ofrece APIs gRPC y REST.
Implementación de un nodo de Lightning Network en C conforme al estándar, que se ejecuta como el daemon lightningd y se controla mediante JSON-RPC.
Un toolkit en Go para wallets de Bitcoin autocustodiadas que integra Ark, swaps de Lightning y pagos on-chain en un único daemon y CLI.
Configuración de despliegue con Docker Compose y Kubernetes para alojar Huly, una plataforma de colaboración en equipo de código abierto y todo en uno.
Un sistema operativo para servidores domésticos que permite alojar servicios por cuenta propia y ofrece una tienda con más de 300 apps para guardar archivos y ejecutar servicios en tu propio hardware.