FAQ

Requirements

• Bitcoin Node (Core, Knots or Libre Relay) fully synced and running.

Which Stratum credentials should be used?

Point your miner to:

• Host: umbrel, umbrel.local, or your Umbrel's IP address (depends on your network settings)
• Port: 3456
• User: user.worker
• Password: x

Does Bassin have an umbrelOS widget?

Yes. Activate the widget from your umbrelOS dashboard.

How can I check the mempool to see if Bassin has found a block?

Bassin uses its own signature, /mined by Bassin/, which appears inside the found block.

Is there a notification when a block is found?

The ckPool instance used by Bassin doesn't report whether a block has been found, nor details about the Bitcoin network's current difficulty. Because of this, Bassin itself has no way of knowing whether a block was found. For privacy reasons, external services like the mempool API are intentionally not used.

Are there any extras for the terminal-inclined?

Bassin includes a dashboard for anyone comfortable in a terminal:

1. Log in to your Umbrel over SSH.
2. cd ~/umbrel/app-data/blockdyor-bassin/data
3. mkdir tools
4. cd tools
5. wget https://raw.githubusercontent.com/blockdyor/blockdyor-umbrel-community-app-store/master/blockdyor-bassin/tools/dashboard.cjs
6. node dashboard.cjs

What settings are used for ckPool?

Bassin runs ckPool with its default settings (see the ckpool configuration reference). Only btcsig and logdir have been adjusted for Bassin. You can edit the configuration at any time; the template lives at:

/data/config/ckpool.conf.template

Stop the Bassin app before editing this file. Suggested difficulty can be set directly in your miner's pool settings.

Is there a system log?

Yes, ckPool writes a log file with pool data, events, and system health information:

tail -100f ~/umbrel/app-data/blockdyor-bassin/data/www/ckpool.log

The data looks incorrect

ckPool performs all measurements and calculations based on data received from your miner. Bassin reads that data from ckPool over its API and displays the numbers as-is, without altering them.

The hashrate chart disappears

Bassin doesn't use a database, so live hashrate data isn't stored permanently. It's only collected while the browser tab is open and active. To save memory, your browser stops collecting data once the tab becomes inactive.

What's the difference between "Best" and "Best Ever"?

ckPool resets the "Best" value every time a block is found. "Best Ever" persists across resets.

What about the community version?

This is the community version. The original creator, duckaxe, has moved on to other projects, and the official listing was left running an outdated version of ckPool. I picked the project back up and keep it updated with the latest ckPool release myself. If you'd prefer the official listing instead, you can find it on the Umbrel App Store.

What does "Bassin" mean?

A bassin de nage is a purpose-built swimming pool for lap swimming.

Anything else?

The Bassin dashboard refreshes every 60 seconds. Watch for the thin progress bar just above the footer.