A functional guide for Handshake users

Fingertip

Fingertip is a menubar app that runs a lightweight decentralized resolver for the Handshake root zone. It integrates with letsdane to provide TLS support without relying on a centralized certificate authority.

How to resolve Handshake names on the internet

Note: The original Fingertip, by Impervious Inc., is no longer maintained. For this guide, I'll be using my personal fork, Fingertip-dit, available for Windows, Linux and macOS. Feel free to fork the project, and don't hesitate to share any comments or suggestions.

0. What you need

1. Installing Fingertip

With Fingertip installed, you can browse Handshake addresses and the regular web as well.

Windows 🪟

Run Fingertip-dit-0.0.4.msi. Before you do:

🪟 Fingertip-dit setup screenshots on Windows

Linux (x86_64) 🐧

chmod +x Fingertip-dit-0.0.4-x86_64.AppImage
./Fingertip-dit-0.0.4-x86_64.AppImage
🐧 Fingertip-dit setup screenshots on Linux

macOS 🍎

Open Fingertip-dit-0.0.4.dmg and drag Fingertip-dit to Applications.

On first start, lookups fail for about 2 minutes while hnsd syncs from its checkpoint. After that, names resolve.

Common issues 🪛

Is your issue not covered by any of the ones below? Feel free to send me an email or summon/DM me on Discord (@galetaire).

The old certificate has expired

Certificates have a limited lifespan, so they eventually expire. To fix this, delete the old certificate manually and then reinstall Fingertip. Once it’s deleted, you’re ready to reinstall. On Windows, the certificate is stored in C:\Users\YOURUSER\AppData\Roaming\Fingertip.

The old certificate has expired
Using a different browser, such as Chrome or Brave

Unlike Firefox, browsers such as Chrome and Brave use your operating system's proxy settings (Windows, macOS or Linux), so you must add the proxy to your OS. If your browser resolves sites after this fix but the address bar says it isn’t secure, it’s because you haven’t added the Fingertip certificate (DNSSEC) to your Trusted Root Certification Authorities. You can usually add it either to your operating system or to the browser only.

Fingertip doesn't open at startup on Linux

For Linux to start Fingertip at login, the AppImage needs to stay in a permanent location. If it's somewhere temporary, Linux won't find it, so Fingertip won't run at startup. Save the AppImage in a folder such as ~/Applications or ~/Documents, not in Downloads.

If you already installed from a temporary folder, go to ~/.config/autostart/ and edit the Exec= line in the fingertip.desktop file so it points to the new location.

[Desktop Entry]
Type=Application
Name=Fingertip
Exec=/home/YOURUSER/Documents/Fingertip.AppImage
X-GNOME-Autostart-enabled=true
X-GNOME-Autostart-Delay=5

2. Uninstalling Fingertip

If you ever want to fully uninstall Fingertip-dit, cleaning all files from your system, there's a step-by-step guide, both for Windows, Linux and macOS, in the project's README.