Specter Desktop in a docker container

Specter Desktop in a docker container.

This is a fork from Lightning Chiang Mai. Big shoutout to them! There might be slight differences and we try to follow the original repo. Ideally the images are the same but eventually: "Don't trust, verify". So we're building them ourself.

Why?

So we can simplify things and make things easier also ease of running through connected devices (raspberry PIs) as this runs cross platform

Building

To build yourself you can run

docker build -t nolim1t/specter-desktop:v0.8.1 . 

Tags

NOTE: For an always up-to-date list see: https://hub.docker.com/r/cryptoadvance/specter-desktop/tags

• latest v0.8.0 v0.8.1
• v0.6.1 v0.7.0 v0.7.1 v0.7.2

Maintainer release notes

The github action takes in the current tag from upstream but you will need to do a

git tag -s vtag.version

and then push the tag. Use of -s meaning the tag should be signed which is highly recommended that you do.

Running

There are two ways you can run this

From docker command

# in HWI bridge mode (meaning you would like to run a bridge to HWI)
# Also ensure that your username is permissioned for accessing the USB device. (group=plugdev) or use the --privileged switch
docker run --rm -v $HOME/.specter:/data/.specter cryptoadvance/specter-desktop:v0.8.1 --hwibridge

# Get the Help to see options
docker run --rm -v $HOME/.specter:/data/.specter cryptoadvance/specter-desktop:v0.8.1 --help

# Run in Daemon mode
docker run --rm -v $HOME/.specter:/data/.specter -v $HOME/.bitcoin:/data/.bitcoin cryptoadvance/specter-desktop:v0.8.1 --host your.ip.address --daemon

# Run in docker detached mode (so we can see the logs)
docker run -d=true --name=specter-desktop --rm -v $HOME/.specter:/data/.specter -v $HOME/.bitcoin:/data/.bitcoin cryptoadvance/specter-desktop:v0.8.1 --host your.ip.address

# with flask env file in root (Replace --help with other stuff
docker run --name=specter-desktop --network=host --rm -v $HOME/.specter:/data/.specter -v $HOME/.bitcoin:/data/.bitcoin -v $HOME/.flaskenv:/.flaskenv cryptoadvance/specter-desktop:v0.8.1 --help

Docker compose

This is a bit complex but the idea is to make sure there is a bitcoind installation. Note that the IP needs to be specified (this is as per design by the specter project). However we probably can hack in an entrypoint to improve the flow of things going forward.

I also used host networking for ease of use, and also added privileged for further ease of use in case your user can't access the usb socket if you would like to run as a bridge to HWI or use the --hwibridge flag

Or you can use the sample docker-compose in HWIBridge mode here

version: '3.8'
services:
        bitcoin:
                image: lncm/bitcoind:v0.20.1
                container_name: bitcoin
                volumes:
                        - ${PWD}/bitcoin:/root/.bitcoin
                        - ${PWD}/bitcoin:/data/.bitcoin
                        - ${PWD}/bitcoin:/data/bitcoin
                restart: on-failure
                ports:
                    - "8333:8333"
                    - "8332:8332"
                stop_grace_period: 20m30s
                network_mode: host
        specter:
                image: lncm/specter-desktop:v0.8.1
                container_name: specter-desktop
                privileged: true
                command: --host ip.addr
                restart: on-failure
                ports:
                    - "25441:25441"
                stop_grace_period: 5m30s
                network_mode: host                    
                volumes:
                        - ${PWD}/.bitcoin:/data/.bitcoin
                        - ${PWD}/.specter:/data/.specter
                        - /dev:/dev
                        - /etc/udev:/etc/udev

Troubleshooting

Please ensure that you have the correct udev rules installed