Skip to content

Log Center

The Log Center records what SigilTTY did — connections opened and failed, transfers, tunnels, key operations — so that when something goes wrong you have evidence, not just a memory of a red error.

  • Mac — Settings (⌘,) › Logs. The viewer sits in the top half of the pane, the settings underneath.
  • iPhone and iPad — Settings › Logs holds the settings; tap View Logs to open the entry list.

Events are grouped into five categories, each with its own switch: Connections, Transfer, Tunnel, Keys and App. All five are on by default; switching one off stops new events, but entries already recorded stay put.

The recording level is Info by default. Switch to Debug while troubleshooting — it adds verbose connection detail that makes authentication and host key problems much easier to diagnose.

Logs are written to local files only — one file per day. They are never synced through iCloud and never appear in the Files app. Two limits keep them from growing unbounded:

  • Auto-Delete After 7 Days — on by default.
  • A 10 MB total cap that is always active, even with auto-delete off: the oldest days are trimmed first, never the current day.

Clear Logs… (with a confirmation) empties the log entirely.

The viewer filters by category, minimum level and source server, and has a search field. Entries are grouped by day; the most recent load first, with Load Older to page further back.

The export button in the viewer toolbar produces a plain-text .log file and hands it to the system share sheet (AirDrop, Mail, Messages…). The export always contains everything recorded, regardless of the filters you had set.

By default the export is redacted: hostnames, usernames, addresses, key names and similar values are replaced with stable pseudonyms like host-3fa2 or user-b41c. The same value always maps to the same pseudonym, so whoever reads the log can still follow the story — “host-3fa2 failed four times in a row” — without learning the real name. Host key fingerprints keep their first 8 characters, so a mismatch report still shows that the old and new keys differ.

A Keep original values switch (off by default) exports the raw text instead — use it only when you trust the recipient with your hostnames.

Some things are excluded at a deeper level than redaction: passwords, private keys, passphrases and Key Handoff verification codes cannot be written to the log at all — the logging layer has no way to record them.

The Log Center panel and everything it exports stay in English even when the app runs in Chinese. That is deliberate: an exported log is written to be read by third parties — a support inbox, a forum thread — and English is the one language every recipient’s tooling can handle.

An exported (redacted) log is the single most useful attachment for a support email — it turns “the connection sometimes fails” into timestamps and error codes. See Contact support.