Tealhand on Linux

Tealhand Host runs on desktops and on computers without a screen: a home server, a NAS, a Raspberry Pi. It runs as you, never as root.

$ tealhand-desktop_amd64.deb: not released yet

The .deb, the AppImage and headless packages for x64 and arm64 come with the first release. Until then, build Tealhand Host from source.

Build it today

You need: Git, Rust through rustup and a C compiler (on Debian or Ubuntu: sudo apt install build-essential git curl), and systemd for the service.

First, get the code, build it and install it for your user.

git clone https://github.com/tealvpn/tealhand
cd tealhand
rustup toolchain install
cargo build -p tealhand-host
mkdir -p ~/.local/bin
install -m 755 target/debug/tealhand-host ~/.local/bin/tealhand-host

Then connect your phone. Over SSH works too.

tealhand-host connect

The QR code is drawn in the terminal. If it is hard to scan, choose Paste the code on the phone and paste the line printed under it.

Then run it as a service that starts at boot.

mkdir -p ~/.config/systemd/user
cp crates/tealhand-host/packaging/tealhand-host.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now tealhand-host
loginctl enable-linger "$USER"

A Raspberry Pi as a waker

A Pi that stays on can wake the other computers on its network when you ask from anywhere. Install Tealhand Host on it with the same steps, connect it to your phone, and leave it running.

The computer to wake must be wired, and its network adapter must be allowed to wake it. Connect that computer to your phone once while it is on: that is how Tealhand learns where to send the signal.

systemctl --user status tealhand-host

Every option, the firewall and updating: Install Tealhand Host on Linux. Stuck? Ask in #help on Discord.