macrokernel/ethereum-wallet-vnc repository overview

⁠Ethereum Wallet

See more on Ethereum Wallet at https://github.com/ethereum/mist/releases/⁠ Ethereum blockchain network and cryptocurrency: https://ethereum.org/⁠

⁠Usage Instructions

In order to access Ethereum Wallet graphical user interface you have to use a VNC client. The connection is secured with a VNC password which you have to create before starting the docker container. Your wallet and VNC password are stored on your host file system outside of the docker image to make them persistent and manageable. All processes inside the Ethereum Wallet docker container including VNC server and Ethereum Wallet itself are running under an unprivileged user account vncuser. In order allow vncuser to access the wallet directory and the VNC password file you have to widen file permissions with chmod. This does not make your wallet or VNC password accessible to other users on your system as long as these files are stored inside your home directory which is only accessible by you (and root).

⁠1 Preparation

1.1 Please create a directory in which your wallet and blockchain data will be stored mkdir -p ~/ethereum/wallet chmod 777 ~/ethereum/wallet

1.2 Then create a file with a VNC password, which you will be using to authenticate yourself when connecting to the Ethereum Wallet docker container x11vnc -storepasswd ~/ethereum/vnc-password chmod 644 ~/ethereum/vnc-password

⁠2 Running the docker image

2.1 Start an Ethereum Wallet container docker run -d --name ethereum-wallet -v ~/ethereum/vnc-password:/home/vncuser/.vnc/passwd -v ~/ethereum/wallet:/home/vncuser/.ethereum/ -p 5900:5900 macrokernel/ethereum-wallet-vnc

⁠3 Connecting to the Ethereum Wallet graphical user interface

3.1 Use your favourite VNC client to connect to the Ethereum Wallet graphical user interface vncviewer <docker host address>:5900

⁠Advanced Usage

⁠Running multiple Ethereum Wallet instances

You may run as many Ethereum Wallet instances on the same docker host as you wish by simply specifying another wallet directory and a unique VNC port docker run -d --name ethereum-wallet-2 -v ~/ethereum/vnc-password:/home/vncuser/.vnc/passwd -v ~/ethereum/wallet2:/home/vncuser/.ethereum/ -p 5902:5900 macrokernel/ethereum-wallet-vnc

⁠Setting alternative Ethereum node sync mode

You may want to set Ethereum node sync mode to fast if the default mode light does not work for you by specifying the SYNC_MODE environment variable docker run -d --name ethereum-wallet -v ~/ethereum/vnc-password:/home/vncuser/.vnc/passwd -v ~/ethereum/wallet:/home/vncuser/.ethereum/ -p 5900:5900 -e SYNC_MODE=fast macrokernel/ethereum-wallet-vnc

⁠Security considerations

⁠Securing connection to your VNC server

If you are going to connect to your Ethereum Wallet container over Internet it is highly advised to use SSH tunnelling. I can recommend using Remmina⁠ remote desktop client which makes tunnelling VNC over SSH very easy - you don't have to run any commands manually.