Hash Commander
← All guides
Home server · no screen

Hash Commander on Umbrel and Docker

If you have a server that stays on 24 hours (an Umbrel, a Raspberry Pi or any machine with Docker), you can run Hash Commander there and open the dashboard from any computer on your network. There is no tray icon or window: it opens in the browser.

Umbrel

Community store. Installs in a few clicks, on a PC (x86) or Raspberry Pi 4/5 (arm64).

Docker

One image for amd64 and arm64, with a single command or with docker compose.

Umbrel

Install from the community store

  1. Open the community stores

    In Umbrel open Settings › App Store › Community App Stores. On umbrelOS 1.x it is App Store › ⋯ › Community App Stores.

  2. Add the store

    Paste this address and click Add:

    https://codeberg.org/hashcommander/umbrel-apps

  3. Install

    Open the Hash Commander store and install the app.

  4. Open the dashboard

    Open the dashboard at your Umbrel's address, on port 8765, for example http://umbrel.local:8765.

The app runs on the host network, so it can find the machines on your local network.

Docker

Install with Docker

  1. Run the container

    On a server with Docker, run:

    docker run -d --name hash-commander --network host -v hc-dados:/data --restart unless-stopped bladept69/hash-commander:latest

  2. Open the dashboard

    In the browser, open http://SERVER-IP:8765. Your data (settings and history) lives in the hc-dados volume, so it survives updates.

  3. Or use docker compose

    If you prefer, save this as docker-compose.yml and run docker compose up -d:

    services: hash-commander: image: bladept69/hash-commander:latest container_name: hash-commander network_mode: host volumes: - hc-dados:/data restart: unless-stopped volumes: hc-dados:

  4. Update

    To move to the new version, pull the image and recreate the container. Your data is kept:

    docker pull bladept69/hash-commander:latest && docker rm -f hash-commander && docker run -d --name hash-commander --network host -v hc-dados:/data --restart unless-stopped bladept69/hash-commander:latest

The image is docker.io/bladept69/hash-commander, with the tags 4.6.23 and latest.

Good to know

LoginThe dashboard asks for your Hash Commander account login, as in the PC app.
No screenThere is no tray icon or window. It always opens in the browser.
WalletThe built-in Lightning wallet is not available in the Docker/Umbrel version yet. Everything else works: machines, pools, alerts, BCH node and market.
StartOSComing soon.

Common problems

The dashboard does not find my machines

Check that the container runs with --network host (Umbrel already does) and that the server is on the same network as the machines.

It does not open at http://IP:8765

Check that the container is running with docker ps and that no firewall blocks port 8765.

Does it work on a Raspberry Pi?

Yes, Raspberry Pi 4 and 5 (arm64), both on Umbrel and with Docker.