macrokernel/metagate repository overview

⁠MetaGate

MetaGate is an application running on #MetHash⁠ decentralised network intended for browsing #MetaApps and using cryptocurrencies with a multi-currency wallet for #MetaHash, ETH, BTC.

See more on MetaGate at https://metagate.metahash.org/⁠ #MetaHash blockchain network and cryptocurrency: https://metahash.org/⁠

⁠Usage Instructions

In order to access MetaGate 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 wallets 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 MetaGate docker container including VNC server and MetaGate itself are running under an unprivileged user account vncuser. In order allow vncuser to access the wallets directory and the VNC password file you have to widen file permissions with chmod. This does not make your wallets 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 wallets will be stored mkdir -p ~/metagate/wallets chmod 777 ~/metagate/wallets

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

⁠2 Running the docker image

2.1 Start a MetaGate container docker run -d --name metagate -v ~/metagate/vnc-password:/home/vncuser/.vnc/passwd -v ~/metagate/wallets:/home/vncuser/.metahash_wallets/ -p 5900:5900 macrokernel/metagate

⁠3 Connecting to MetaGate graphical user interface

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

⁠Advanced Usage

⁠Running multiple MetaGate instances

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

⁠Security considerations

⁠Securing connection to your VNC server

If you are going to connect to your MetaGate 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.

#