A Handshake enabled Chromium web browser and reference client; works with HSD and the HNSD light client. Use our example to build or integrate Handshake into any browser.
MacOS Docker Download - https://docs.docker.com/docker-for-mac/release-notes/
After installing Docker, run the Docker application first, then open the HandyBrowser application for the install to begin. The setup will take just a few minutes, and it only needs to do this once, so please be patient. Use CTRL + Right Click to Open the launcher and accept the permissions if prompted with a security warning; this is due to HandyBrowser not coming from the official Mac App Store.
Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:
Windows Docker Download - https://docs.docker.com/docker-for-windows/release-notes/
After installing Docker, run the Docker application first, then simply double click HandyBrowser.exe to begin the install. The setup will take just a few minutes, and it only needs to do this once, so please be patient.
We need the command certutil
in order to write the Root CA Certificate for HandyBrowser (and Chrome) to use.
On Ubuntu:
sudo apt install libnss3-tools
will install the certutil command
Docker Download: - https://docs.docker.com/engine/install/
Docker needs sudo out of the box. If you dont want to run this app with sudo ::
sudo usermod -aG docker $USER
Once done, restart your device. after that you can start the browser either by double clicking HandyBrowser.desktop in this folder, or ./HandyBrowser
sudo ./HandyBrowser
Why sudo? Docker needs sudo permissions to run. Tinfoil hat on: Within the HandyBrowser Application, node.js is locked down to only file:// protocol (ie: the navigation tray layout/UI) and NOT anything coming in from the web. Any browser content will not have any permissions to node.js.
Windows Docker Download - https://docs.docker.com/docker-for-windows/release-notes/
After installing Docker, run the Docker application first, then simply double click HandyBrowser.exe
to begin the install. The setup will take just a few minutes, and it only needs to do this once, so please be patient.
Docker Download: - https://docs.docker.com/engine/install/
Docker needs sudo out of the box. If you dont want to run this app with sudo ::
sudo usermod -aG docker $USER
Once done, restart your device. after that you can start the browser either by double clicking HandyBrowser.desktop in this folder, or ./HandyBrowser
sudo ./HandyBrowser
Why sudo? Docker needs sudo permissions to run. Tinfoil hat on: Within the HandyBrowser Application, node.js is locked down to only file:// protocol (ie: the navigation tray layout/UI) and NOT anything coming in from the web. Any windows loaded over http/https will not have any permissions to node.js.
MacOS Docker Download - https://docs.docker.com/docker-for-mac/release-notes/
After installing Docker, run the Docker application first, then open the HandyBrowser application for the install to begin. The setup will take just a few minutes, and it only needs to do this once, so please be patient.