Skip to content

HandyHost v0.4.7 (Debian and MacOS)

Compare
Choose a tag to compare
@alexsmith540 alexsmith540 released this 05 Oct 19:09
· 117 commits to master since this release

MacOS Install Instructions

Prerequisites:

  1. 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.
  2. 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)"
  3. 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

  1. Download the release (handyhost_v0.4.7.deb) below from Assets, and save it to file (for example, in Downloads).
  2. Open a terminal, and cd where you downloaded, example: cd ~/Downloads
  3. 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).