Skip to content

Linux + iPhone Continuity / iMessage / SMS

1.9 KB
Raw Blame
.TH TETHERD 8 "@BUILD_DATE@" "Tether @TETHER_VERSION@" "System Administration"
.SH NAME
tetherd \- Tether background daemon for iOS/Wayland integration
.SH SYNOPSIS
.B tetherd
.SH DESCRIPTION
.B tetherd
 is a background daemon that manages the connection between a Linux Wayland
compositor and an iOS device running the Tether app. It handles clipboard
synchronization, file transfers, and device pairing using TLS with pinned certificates.

The daemon advertises its presence on the local network using mDNS (Bonjour)
and listens for incoming connections on TCP port 5134 by default. It also
provides a UNIX domain socket at \fB$XDG_RUNTIME_DIR/tether/tetherd.sock\fR
for local communication with the \fBtether\fR(1) CLI and \fBtether-gtk\fR(1) GUI.
.SH FIREWALL
Inbound \fB5134/tcp\fR must be reachable for the iPhone to connect, and
\fB5353/udp\fR for mDNS discovery, which \fBavahi-daemon\fR(8) owns. A
default-deny firewall commonly passes mDNS while dropping 5134, so the phone
discovers this machine and then cannot reach it.

Profiles for \fBufw\fR(8) and \fBfirewalld\fR(1) are installed but never
applied; run \fBufw allow Tether\fR or
\fBfirewall-cmd --permanent --add-service=tether\fR to use them. A source
install writes each profile only if that tool's directory already exists;
packages always carry both.
.SH FILES
.TP
\fB/etc/ufw/applications.d/tether\fR
ufw application profile. Inert until allowed.
.TP
\fB/usr/lib/firewalld/services/tether.xml\fR
firewalld service definition. Inert until added to a zone.
.TP
\fB$XDG_RUNTIME_DIR/tether/tetherd.sock\fR
The UNIX domain socket used for local communication.
.TP
\fB$XDG_RUNTIME_DIR/tether/tetherd.lock\fR
Advisory lock file to ensure only one instance of the daemon is running.
.TP
\fB~/.config/tether/\fR
Directory containing the TLS certificate (\fBcert.pem\fR), private key (\fBkey.pem\fR),
and pinned device fingerprints (\fBknown_hosts.json\fR).
.SH SEE ALSO
.BR tether (1),
.BR tether-gtk (1)