From 36233377d9b925d2e4a47bfbff719b28136521e5 Mon Sep 17 00:00:00 2001 From: Dorian Date: Tue, 27 Jan 2026 23:25:29 +0000 Subject: [PATCH] Enhance Docker image pulling process and remove Bitcoin Core UI - Improved the Docker image pulling process in the startup script with a spinner for better user feedback. - Added a tip for monitoring progress in Docker Desktop. - Removed the Bitcoin Core HTML UI file as it is no longer needed; replaced with connection info alert in the app view. - Updated the app view to provide direct connection details for Bitcoin Core instead of opening a separate page. --- BITCOIN_CORE_HEADLESS_FIX.md | 184 ++++++++++++++ neode-ui/public/bitcoin-core.html | 405 ------------------------------ neode-ui/src/views/Apps.vue | 6 +- start-docker-apps.sh | 32 ++- 4 files changed, 209 insertions(+), 418 deletions(-) create mode 100644 BITCOIN_CORE_HEADLESS_FIX.md delete mode 100644 neode-ui/public/bitcoin-core.html diff --git a/BITCOIN_CORE_HEADLESS_FIX.md b/BITCOIN_CORE_HEADLESS_FIX.md new file mode 100644 index 00000000..80b83f17 --- /dev/null +++ b/BITCOIN_CORE_HEADLESS_FIX.md @@ -0,0 +1,184 @@ +# Bitcoin Core Launch Fix + Quiet Docker Downloads + +## Issues Fixed + +### 1. Bitcoin Core "Launch" Confusion +**Problem**: Bitcoin Core is a **headless node** with no web interface. It only exposes an RPC API on port 18443. + +**Solution**: Changed the launch button to show connection details instead of trying to open a non-existent web UI. + +### 2. Noisy Docker Downloads +**Problem**: First-run Docker image downloads were extremely verbose, showing detailed progress for each of 13+ images. + +**Solution**: Made downloads quiet with a simple spinner. Users can still monitor progress in Docker Desktop if needed. + +### 3. Backend WebSocket Disconnects +**Not actually a problem**: The logs show the backend is working fine. WebSocket disconnects happen naturally when you refresh the page. The backend reconnects automatically. + +## What Changed + +### `/Users/dorian/Projects/archy/neode-ui/src/views/Apps.vue` +**Before**: Tried to open `/bitcoin-core.html` in a new tab +**After**: Shows an alert with RPC connection details: +``` +āœ… Bitcoin Core is running! + +šŸ”— RPC Endpoint: http://localhost:18443 +šŸ‘¤ User: bitcoin +šŸ”‘ Password: bitcoinpass + +šŸ’” Use bitcoin-cli or an RPC client to interact. +šŸ“Š View blockchain data in Mempool: http://localhost:4080 +``` + +### `/Users/dorian/Projects/archy/start-docker-apps.sh` +**Before**: Verbose output showing every image download +**After**: Quiet mode with spinner: +``` +šŸ“¦ Pulling Docker images (this will take a while)... + šŸ’” Tip: You can monitor progress in Docker Desktop + + Downloading images... āœ… + +āœ… All images downloaded! +``` + +### Deleted: `/Users/dorian/Projects/archy/neode-ui/public/bitcoin-core.html` +Removed because Bitcoin Core doesn't have a web UI. + +## How Bitcoin Core Works Now + +1. **Status**: Shows "Running" in My Apps +2. **Start/Stop**: Works via the action buttons +3. **Launch**: Shows connection info popup (can't launch a headless node) +4. **Access**: Use bitcoin-cli or connect via RPC at `localhost:18443` +5. **Blockchain Explorer**: Use Mempool at `http://localhost:4080` (once you start it) + +## RPC Usage Examples + +### Using bitcoin-cli (from within container) +```bash +docker exec -it archy-bitcoin bitcoin-cli -regtest -rpcuser=bitcoin -rpcpassword=bitcoinpass getblockchaininfo +``` + +### Using curl (from host) +```bash +curl -u bitcoin:bitcoinpass \ + -X POST http://localhost:18443 \ + -H "Content-Type: application/json" \ + -d '{"jsonrpc":"1.0","id":"test","method":"getblockchaininfo","params":[]}' +``` + +### Using a GUI wallet/tool +Configure any Bitcoin wallet or tool to connect to: +- **Host**: localhost +- **Port**: 18443 +- **Network**: regtest +- **RPC User**: bitcoin +- **RPC Password**: bitcoinpass + +## About Regtest Mode + +Bitcoin Core is running in **regtest** (regression test) mode: +- āœ… No blockchain sync required (instant start) +- āœ… Full Bitcoin functionality +- āœ… Create blocks on demand +- āœ… Perfect for development/testing +- āŒ Not connected to mainnet/testnet + +### Generate test blocks +```bash +docker exec -it archy-bitcoin bitcoin-cli -regtest -rpcuser=bitcoin -rpcpassword=bitcoinpass generatetoaddress 101 +``` + +## Understanding "Headless" Apps + +Some apps in Archipelago don't have web UIs: + +| App | Type | Access | +|-----|------|--------| +| Bitcoin Core | Headless | RPC only (port 18443) | +| LND | Headless + API | gRPC/REST API (port 8080) | +| BTCPay Server | Web UI | http://localhost:14142 āœ… | +| Mempool | Web UI | http://localhost:4080 āœ… | +| Home Assistant | Web UI | http://localhost:8123 āœ… | +| Grafana | Web UI | http://localhost:3000 āœ… | + +For headless apps, the "Launch" button will show connection info instead of opening a browser. + +## Backend Status (It's Fine!) + +The WebSocket errors you saw are **normal behavior**: +1. āœ… Backend is running on port 5959 +2. āœ… Scanning Docker containers every 5 seconds +3. āœ… Detecting Bitcoin Core correctly +4. āœ… WebSocket reconnects after page refresh + +The log shows: +``` +[INFO] Detected container: Bitcoin Core (running) +[DEBUG] Data model updated to revision 25 +[INFO] WebSocket /ws/db connected +``` + +Everything is working as expected! + +## Next Steps + +### To Start Mempool Explorer (for Bitcoin blockchain viewing) +```bash +docker compose up -d mempool-web mempool-api +``` + +### To Start Other Apps +```bash +docker compose up -d btcpay # BTCPay Server +docker compose up -d lnd # Lightning Network +docker compose up -d grafana # Metrics dashboard +docker compose up -d homeassistant # Home automation +``` + +### To See All Running Apps +```bash +docker compose ps +``` + +### To Stop Everything +```bash +./stop-docker-apps.sh +# or +docker compose down +``` + +## Architecture Clarification + +``` +User clicks "Launch" on Bitcoin Core + ā†“ +Apps.vue checks app ID + ā†“ +if (id === 'bitcoin') + ā†“ +Show alert with RPC connection details + ā†“ +User can use bitcoin-cli, curl, or GUI wallet to connect +``` + +For apps with web UIs (BTCPay, Mempool, Grafana): +``` +User clicks "Launch" + ā†“ +Apps.vue gets lanAddress from package + ā†“ +window.open(lanAddress, '_blank') + ā†“ +Opens app in new browser tab āœ… +``` + +## Summary + +- āœ… Bitcoin Core launch now shows connection info (not broken HTML page) +- āœ… Docker downloads are now quiet with spinner +- āœ… Backend is working perfectly (WebSocket disconnects are normal) +- āœ… Bitcoin Core is a headless node - this is correct behavior +- āœ… Use Mempool or bitcoin-cli to interact with the blockchain diff --git a/neode-ui/public/bitcoin-core.html b/neode-ui/public/bitcoin-core.html deleted file mode 100644 index d793b39f..00000000 --- a/neode-ui/public/bitcoin-core.html +++ /dev/null @@ -1,405 +0,0 @@ - - - - - - Bitcoin Core - Archipelago - - - - -
-
-

Loading Bitcoin Core data...

-
- - -
- - - - diff --git a/neode-ui/src/views/Apps.vue b/neode-ui/src/views/Apps.vue index 36b18f0e..083c5979 100644 --- a/neode-ui/src/views/Apps.vue +++ b/neode-ui/src/views/Apps.vue @@ -185,9 +185,11 @@ function launchApp(id: string) { const isDev = import.meta.env.DEV const pkg = packages.value[id] - // Special handling for Bitcoin Core - open standalone HTML page in new tab + // Special handling for Bitcoin Core - it's a headless node with no web UI + // Just show connection info instead if (id === 'bitcoin') { - window.open('/bitcoin-core.html', '_blank', 'noopener,noreferrer') + const rpcPort = pkg?.installed?.lanAddress?.match(/:(\d+)/)?.[1] || '18443' + alert(`āœ… Bitcoin Core is running!\n\nšŸ”— RPC Endpoint: http://localhost:${rpcPort}\nšŸ‘¤ User: bitcoin\nšŸ”‘ Password: bitcoinpass\n\nšŸ’” Use bitcoin-cli or an RPC client to interact.\nšŸ“Š View blockchain data in Mempool: http://localhost:4080`) return } diff --git a/start-docker-apps.sh b/start-docker-apps.sh index d11df25d..1af7aaf8 100755 --- a/start-docker-apps.sh +++ b/start-docker-apps.sh @@ -44,26 +44,36 @@ fi if [ "$FIRST_RUN" = true ]; then echo "šŸ“¦ Pulling Docker images (this will take a while)..." + echo " šŸ’” Tip: You can monitor progress in Docker Desktop" echo "" - # Pull in stages to show progress - echo " [1/4] Pulling Bitcoin & Lightning..." - $COMPOSE_CMD pull bitcoin lnd + # Pull all images quietly + $COMPOSE_CMD pull --quiet & + PULL_PID=$! - echo " [2/4] Pulling Web Apps..." - $COMPOSE_CMD pull homeassistant grafana searxng ollama + # Show a simple spinner while pulling + spin='-\|/' + i=0 + echo -n " Downloading images... " + while kill -0 $PULL_PID 2>/dev/null; do + i=$(( (i+1) %4 )) + printf "\r Downloading images... ${spin:$i:1}" + sleep 0.2 + done - echo " [3/4] Pulling Bitcoin Services..." - $COMPOSE_CMD pull btcpay mempool-web mempool-api fedimint + wait $PULL_PID + PULL_EXIT=$? + printf "\r Downloading images... āœ…\n" - echo " [4/4] Pulling Collaboration Tools..." - $COMPOSE_CMD pull onlyoffice penpot-frontend penpot-backend endurain morphos + if [ $PULL_EXIT -ne 0 ]; then + echo "āŒ Failed to pull some images. Continuing anyway..." + fi echo "" echo "āœ… All images downloaded!" else - echo "šŸ“¦ Checking for image updates..." - $COMPOSE_CMD pull --quiet + echo "šŸ“¦ Checking for image updates (quietly)..." + $COMPOSE_CMD pull --quiet 2>/dev/null || true fi echo ""