Wholly Crypto con Docker.

Antes de empezar.

Usa un nuevo VPS Linux amd64 / x86-64 con acceso root, Python 3.9+, Git, Docker Engine y su plugin Compose. Empieza con 2 vCPU, 4 GB RAM y 30 GB SSD para uso ligero. Deja espacio para historial, imágenes y copias de seguridad.

Mantén los puertos 80 y 443 libres y abiertos en ambos firewalls. Apunta los registros DNS de comercio, pago y API al VPS. Con Cloudflare, usa solo DNS durante la instalación; activa el proxy después de terminar la validación HTTPS.

Elige Docker o el instalador nativo. La instalación Docker no mueve una instalación existente ni detiene otro servidor web.

Instala con tres comandos.

git clone https://github.com/whollycrypto-com/whollycrypto-docker.git /root/whollycrypto-docker
cd /root/whollycrypto-docker
./whollycrypto-docker setup

Elige dominios, IP pública del VPS, email de renovación, moneda fiat y un acceso Basic Auth. Los valores predeterminados son merchant.example.com, pay.example.com y api.example.com. Puedes elegir otros nombres de subdominio.

La instalación construye la imagen de ejecución, verifica la descarga firmada de comercio, inicia PostgreSQL 18 y emite certificados HTTPS. GitHub es la alternativa de descarga. No necesitas código fuente del comercio, compilador Rust ni nodo de blockchain.

Espera a ver Ready: https://… en el log. Abre esa dirección, introduce tu acceso Basic Auth y crea la cuenta de administrador. Si la instalación se detiene, corrige el problema indicado y ejecuta ./whollycrypto-docker resume. Se conservan las claves de wallets existentes.

Repositorio y guía completa de instalación ↗

Gestiona la instalación.

Ejecuta esto desde /root/whollycrypto-docker. La consola, página de pago, API y reglas de créditos de procesamiento funcionan como en la instalación nativa.

Ajustes → Sistema también puede instalar actualizaciones del comercio. Reconstruir una imagen Docker no sustituye el comercio instalado ni evita las comprobaciones de actualización. Actualiza las dependencias del contenedor por separado siguiendo las instrucciones runtime-update del repositorio.

Guarda una copia fuera del VPS.

./whollycrypto-docker backup

Esta copia completa pausa brevemente la página de pago. Guarda y verifica la base de datos, archivos del comercio, clave de cifrado de wallets, Nginx, certificados y secretos de configuración correspondientes. Copia el directorio de copia completo con su marca de tiempo a un almacenamiento seguro sin conexión.

Las copias contienen claves privadas y credenciales sin cifrar. Nunca las pongas en Git ni en una carpeta pública. Exporta también copias de las wallets del proyecto desde la consola. Las wallets Lightning conectadas necesitan su propio procedimiento de recuperación.

Nunca uses docker compose down -v para corregir un error. Elimina los volúmenes persistentes y puede destruir claves de wallets e historial de pagos. Usa docker compose stop para detener sin borrar datos. Sigue la guía de recuperación antes de restaurar.

Pocos componentes. Datos separados.

Dos contenedores: comercio con Nginx y PostgreSQL. Los datos sobreviven a la sustitución de contenedores en volúmenes con nombre. La base de datos usa un socket Unix privado; no se publican los puertos 5432 ni 8080. No se necesita modo privilegiado, red del host ni socket Docker del host.

Docker usa aislamiento de contenedores, no el sandbox systemd del instalador nativo. Root y los administradores Docker siguen pudiendo acceder a tus claves. Mantén Basic Auth y restricciones de IP de dominio/API adecuadas. Publicar puertos Docker puede saltarse las reglas UFW; comprueba el firewall del proveedor y las recomendaciones de firewall de Docker.

La configuración Docker inicial está dirigida a Linux amd64 con su propio Nginx. ARM64, Docker Desktop, Docker sin root y un proxy inverso adicional todavía no son configuraciones compatibles.