Self-Hosted Crypto Wallet Reliability: Docker Healthcheck and Auto-Recovery

Описание и применение

Самостоятельный запуск криптовалютного кошелька с Docker обеспечивает автоматическое восстановление после падения контейнера, используя встроенную проверку состояния и политику перезапуска, а также защищает данные с помощью Docker Secrets.

Задача

A self-hosted crypto wallet container can silently crash, leaving an AI agent unable to transact until the issue is detected and the container restarted.

Результат

By leveraging Docker’s built‑in healthcheck and restart policies, WAIaaS provides a reliable self‑hosted wallet that automatically recovers from crashes, preserves wallet data via named volumes, and secures credentials with Docker Secrets.

Рабочий процесс

• Clone the WAIaaS repo and run docker compose up -d to start the daemon and push‑relay containers.
• Verify the container is running and healthy with docker compose logs -f and curl http://127.0.0.1:3100/health.
• If using auto‑provision, run docker run -d --name waiaas -p 127.0.0.1:3100:3100 -v waiaas-data:/data -e WAIAAS_AUTO_PROVISION=true ghcr.io/waiaas/waiaas:latest and retrieve the recovery key with docker exec waiaas cat /data/recovery.key.
• For production, create a Docker Secrets overlay to store the master password securely and deploy with docker compose -f docker-compose.yml -f docker-compose.secrets.yml up -d.
• Configure environment variables such as WAIAAS_DAEMON_HOSTNAME, WAIAAS_DAEMON_PORT, and RPC endpoints to match your infrastructure.
• Use the OpenAPI spec at /doc or the Scalar UI at /reference to test wallet functionality.
• Monitor the health endpoint or integrate with tools like Portainer or Watchtower to receive alerts on unhealthy status.

Доказательства

The official Docker Compose configuration ships with a healthcheck already wired in:

Источник

<strong>restart: unless-stopped</strong> means Docker will automatically restart the container after a crash, an OOM kill, or a host reboot — without any additional process manager.

Источник

Named volumes (<code>waiaas-data</code>) mean your wallet data, session tokens, and configuration survive a <code>docker compose down</code> and come back intact on <code>docker compose up -d</code>.

Источник