OPTIONELE INSTALLATIE

Wholly Crypto met Docker.

Dezelfde handelaarssoftware, in containers. Behoud de native installatie als die al voor je werkt.

Voordat je begint.

Gebruik een nieuwe Linux amd64 / x86-64-VPS met roottoegang, Bash en curl. De installatie biedt na je bevestiging aan om ontbrekende Python 3.9+, Git, Docker Engine, Docker Compose en Buildx te installeren.

Begin voor licht gebruik met 2 vCPU, 4 GB RAM en 30 GB SSD. Houd ruimte vrij voor geschiedenis, images en back-ups.

Automatische installatie van vereisten: Ubuntu 22.04/24.04/26.04, Debian 12/13, Fedora 43/44/45 en RHEL 9/10. Installeer op andere distributies de vereisten eerst zelf.

Houd poorten 80 en 443 vrij en open in beide firewalls. Laat DNS-records voor handelaar, afrekenen en API naar de VPS verwijzen. Gebruik bij Cloudflare alleen DNS tijdens de installatie; schakel de proxy in nadat HTTPS-validatie is voltooid.

Kies Docker of het native installatieprogramma. De Docker-installatie verplaatst geen bestaande installatie en stopt geen andere webserver.

Installeer met één opdracht.

bash <(curl -fsSL https://raw.githubusercontent.com/whollycrypto-com/whollycrypto-docker/v1.1.1/install.sh)

Kies domeinen, het publieke VPS-IP, een e-mailadres voor verlenging, fiatvaluta en Basic Auth-inloggegevens. Standaard zijn dit merchant.example.com, pay.example.com en api.example.com. Je kunt andere subdomeinnamen kiezen.

De installatie bouwt de runtime-image, verifieert de ondertekende handelaarsdownload, start PostgreSQL 18 en geeft HTTPS-certificaten uit. GitHub dient als uitwijkmogelijkheid voor downloads. Handelaarsbroncode, een Rust-compiler of een blockchainnode zijn niet nodig.

Bestaande engines, containers en volumes blijven behouden. De installatie stopt voor handmatige beoordeling als conflicterende pakketten worden gevonden.

Wacht op Ready: https://… in het logboek. Open dat adres, voer je Basic Auth-inloggegevens in en maak je beheerdersaccount. Als de installatie stopt, verhelp dan het gemelde probleem en voer ./whollycrypto-docker resumeuit. Bestaande walletsleutels blijven behouden.

Repository en volledige installatiehandleiding ↗

Beheer de installatie.

Voer deze uit vanuit /root/whollycrypto-docker. Console, afrekenen, API en regels voor verwerkingstegoed werken zoals bij de native installatie.

OpdrachtGebruik dit voor
./whollycrypto-docker statusContainerstatus
./whollycrypto-docker logsInstallatievoortgang en workerlogboeken
./whollycrypto-docker doctorControles zonder wijzigingen
./whollycrypto-docker updateOndertekende handelaarsupdate
./whollycrypto-docker cli htaccessBasic Auth wijzigen
./whollycrypto-docker cli sslHTTPS controleren of herstellen

Instellingen → Systeem kan ook handelaarsupdates installeren. Een Docker-image opnieuw bouwen vervangt de geïnstalleerde handelaarssoftware niet en omzeilt geen updatecontroles. Werk containerafhankelijkheden afzonderlijk bij volgens de runtime-update-instructies van de repository.

Bewaar een kopie buiten de VPS.

./whollycrypto-docker backup

Deze volledige back-up pauzeert afrekenen kort. Hij bewaart en verifieert de database, handelaarsbestanden, walletversleutelingssleutel, Nginx, certificaten en bijbehorende installatiegeheimen. Kopieer de volledige back-upmap met tijdstempel naar veilige offline opslag.

Back-ups bevatten onversleutelde private sleutels en inloggegevens. Zet ze nooit in Git of een publieke map. Exporteer ook projectwalletback-ups vanuit de console. Verbonden Lightning-wallets vereisen hun eigen herstelprocedure.

Gebruik nooit docker compose down -v om een fout op te lossen. Dit verwijdert blijvende volumes en kan walletsleutels en betaalgeschiedenis vernietigen. Gebruik ./whollycrypto-docker stop om te stoppen zonder gegevens te verwijderen. Volg de herstelhandleiding voordat je herstelt.

Kleine opzet. Afzonderlijke gegevens.

Twee containers: handelaarssoftware met Nginx en PostgreSQL. Gegevens overleven containervervanging in benoemde volumes. De database gebruikt een private Unix-socket; poorten 5432 en 8080 worden niet gepubliceerd. Bevoorrechte modus, hostnetwerken of de Docker-socket van de host zijn niet nodig.

Docker gebruikt containerisolatie, niet de systemd-sandbox van de native installatie. Root- en Docker-beheerders kunnen nog steeds bij je sleutels. Houd Basic Auth en passende IP-beperkingen voor domeinen/API ingeschakeld. Docker-poortpublicatie kan UFW-regels omzeilen; controleer de firewall van je provider en de Docker-firewallrichtlijnen.

De eerste Docker-installatie is gericht op Linux amd64 met een eigen Nginx. ARM64, Docker Desktop, rootless Docker en een extra reverse proxy zijn nog geen ondersteunde configuraties.