App Submission: Bassin

[duckaxe]

A zero-fee Bitcoin solo mining pool for umbrellOS. Run your own CKPOOL at home.

App Submission

Bassin

...

256x256 SVG icon

...

Gallery images

App Screenshots

A zero-fee Bitcoin Solo Mining Pool for your Umbrel.

Every decentralized share counts.

No setup. Just point your miner to Bassin.

...

I have tested my app on:

• umbrelOS on a Raspberry Pi
• umbrelOS on an Umbrel Home
• umbrelOS on Linux VM

[al-lac]

Hey @duckaxe,

great submission!

Would it be possible to package all of the website files (html, js, css) into a separate container instead of serving them via the static-file-server one?

Otherwise we will have a hard time with updating in case something needs to be changed.

[duckaxe]

@al-lac I have already tried it. It's complicated because the CKPOOL (log & json) files and front-end assets must be in the same folder (data/www) and accessible via the same web server.

I noticed that some Umbrel apps include front-end assets. That's why I did it this way. It is and will remain a single-page application. Only the JS and CSS files will change, if at all. Everything else stays the same.

This makes things much easier for me.

[al-lac]

Hey @duckaxe, ok got it. Lets see what @nmfretz has to say about it.

Usually it is fine to just have some simple html files in there, but once we go into javascript and other logic we have to think about what makes sense here.

[duckaxe]

Thank you for response, @al-lac
Then waiting for @nmfretz

[duckaxe]

@al-lac I found a way to extract the user interface into a docker image. It's much cleaner now ;)
I also updated the gallery images.

[al-lac]

Awesome work @duckaxe! 🚀

I made some adaptions to the description formatting and removed the leftover directory.

[duckaxe]

@al-lac Thanks for that. You added awaiting gallery assets flag - I already provided all ready2go gallery assets. Do we need more?

[al-lac]

Hey @duckaxe, really great work on those assets! 🔥

I added the label as there is usually a final design check and possible adaptions before apps make it to the store.

But don't worry, does not take too long usually!

[duckaxe]

❤️

[duckaxe]

But don't worry, does not take too long usually!

Hope it happens soon.

[al-lac]

Hey @duckaxe, thanks a lot for your patience. The app store assets are now ready.

Upon reviewing the app once more together with @nmfretz we found the following topics that should be addressed before the go live:

1. There is a race condition for chkpool as it is starting up before the init container is done creating the required folders and config files. This is not a deal breaker as chkpool retries until the files are there, but you may want to take a look at it:

bassin_ckpool_1     | [2025-10-08 12:28:14.194] Json decode error for config file /config/ckpool.conf: (-1): unable to open /config/ckpool.conf: No such file or directory
bassin_ckpool_1     | Failed to make log directory logs/

2. It appears that any ckpool error, including cases where bitcoind isn't fully synced, results in the UI showing nothing but a pulsing loading animation.

I also suggested some changes to the tagline and description.

Once these points are cleared up, we should be able to merge.

[duckaxe]

@al-lac Thank you for your comments.

1. My knowledge in this area is limited. Unfortunately, I have no idea how to solve this problem.
2. The loading indicator is a kind of fallback for all cases where something goes wrong. A generic error message would not help the user. The note “Blockchain must be synchronized” is included in the app description & FAQ.

I would deploy the current version and wait for user feedback to see how many users have a problem with it.

[al-lac]

Hey @duckaxe,

About 1), the suggested changes should fix this.

For 2), fine for us!

One last thing, the app does not work on processors that do not support the AVX2 instruction set. Please look into building the container without it or maybe there is already a fix upstream.

[al-lac]

Is generated automatically by umbrelOS.

Suggested change

container_name: bassin_app_proxy_1

[al-lac]

Is generated automatically by umbrelOS.

Suggested change

container_name: bassin_ckpool_1

[al-lac]

Is generated automatically by umbrelOS.

Suggested change

container_name: bassin_www_1

[al-lac]

This makes sure that ckpool only gets started after init is done.

Suggested change

	- init
	init:
	condition: service_completed_successfully

[github-actions]

⚠️   Linting finished with 1 warning   ⚠️

Thank you for your submission! This is an automated linter that checks for common issues in pull requests to the Umbrel App Store.

Please review the linting results below and make any necessary changes to your submission.

Linting Results

Severity	File	Description
ℹ️	bassin/docker-compose.yml	External port mapping "3456:3333/tcp": Port mappings may be unnecessary for the app to function correctly. Docker's internal DNS resolves container names to IP addresses within the same network. External access to the web interface is handled by the app_proxy container. Port mappings are only needed if external access is required to a port not proxied by the app_proxy, or if an app needs to expose multiple ports for its functionality (e.g., DHCP, DNS, P2P, etc.).
ℹ️	bassin/docker-compose.yml	Potentially using unsafe user in service "init": The default container user "root" can lead to security vulnerabilities. If you are using the root user, please try to specify a different user (e.g. "1000:1000") in the compose file or try to set the UID/PUID and GID/PGID environment variables to 1000.
⚠️	bassin/umbrel-app.yml	"icon" and "gallery" needs to be empty for new app submissions: The "icon" and "gallery" fields must be empty for new app submissions as it is being created by the Umbrel team.

Legend

Symbol	Description
❌	Error: This must be resolved before this PR can be merged.
⚠️	Warning: This is highly encouraged to be resolved, but is not strictly mandatory.
ℹ️	Info: This is just for your information.

[duckaxe]

@al-lac Thank you very much for improvements. I didn't remove the container_name: bassin_www_1 because the dashboard widget doesn't work after removing this line. I have adopted other suggestions.

[al-lac]

Hey @duckaxe, thanks a lot for making the adaptions! 👍

Really weird that it does not work without the container_name: bassin_www_1, maybe something going wrong with DNS.

Did you also check the issue with the ckpool image? Did not see a change here, so the app would still be broken on some amd64 devices.

[duckaxe]

@al-lac the ckpool image was created by using the following command where amd64 is included:
docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/duckaxe/ckpool-solo:main --push .

https://github.com/duckaxe/ckpool-solo