HandyHost v0.4.7 (Debian and MacOS)
MacOS Install Instructions
Prerequisites:
- some xcode command line tools are required during building of dependencies. You must run
sudo xcode-select --install
on your terminal before running the installer. - The various projects depend on standard packages installed from homebrew.
You can run this command to install Homebrew on your system:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Docker. DVPN runs its service in containers, thus you need Docker. Now that we have homebrew it is easy to install. Just run:
brew install --cask docker
. Once installed, open the Docker.app (in /Applications), accept the EULA, and then you can close the Docker application and continue the install.
After installing prerequisites, the double click package installer (HandyHost_v0.4.7.pkg) in this Release will take ~20-30 minutes to download/compile all dependencies.
To tail the installer progress logs, you can run tail -f /var/log/install.log
in your terminal.
Once the installer is finished it will auto-launch the HandyHost Service as well as launch the StatusBar control (top-right mini icon) which you can use to stop/start and launch the GUI. HandyHost will start after the user logs-in after any restart event.
Debian/Ubuntu Install Instructions
- Download the release (handyhost_v0.4.7.deb) below from Assets, and save it to file (for example, in Downloads).
- Open a terminal, and cd where you downloaded, example:
cd ~/Downloads
- Install with dpkg with this command:
sudo dpkg -i handyhost_v0.4.7.deb || sudo apt install -f -y
Install will take ~20-30mins, the terminal logs will show how its going. Upon finish, the terminal will list the URLs to access the tool.
To start and stop HandyHost Daemon:
sudo systemctl stop handyhost
with command verbs available: stop | start | restart
HandyHost Daemon will restart on machine start.
Logs can be tailed with tail -f /var/log/handyhost.log
Future .deb builds outside of the in-app update methods can be installed via double clicking (assuming no new apt dependencies).