Guide and reference
FAQ
Host missing from the menu
The menu reads valid aliases from
~/.ssh/config and its Include files. Settings lists
refused aliases and hidden top-level hosts, while reload hosts
reads the files again. A hidden alias remains usable in a typed address.
SSH connection failure
Run ssh -o BatchMode=yes <alias> true in Terminal
after accepting the host key and preparing your key or agent. Exit status
zero confirms access without login prompts. The field probe distinguishes
unreachable hosts, missing key authentication, and probe output that cannot
be parsed. See Configuring SSH.
Local and remote paths
/path and ~/path refer to this
Mac. host:/path and host:~/path refer to the named
SSH host. See Addresses and pasted paths for the
complete grammar.
Plan refusal
Common causes include a file-versus-directory collision, an existing rename target, unreadable destination facts, changed bound topology, missing capabilities, and pool-root dataset destroy or rename. The panel records the specific cause before any command runs.
Transfer route through the Mac
The plan's transport line identifies the process host and byte path. A forwarded-agent route transfers directly between servers, a proxy route streams through the Mac, and a local endpoint also places the Mac in the byte path.
Background activity while open
Local panes watch their directories, and active remote panes re-list every ten seconds while the application is frontmost. Field topology changes after an explicit probe or a completed ZFS operation. A release build also checks GitHub once at launch when update checks are enabled.
Activity after quitting
The application installs no daemon or launch agent. Quit closes SSH sessions, stops pane refresh, and terminates application-owned commands.
Local state files
~/Library/Application Support/palana/
contains six files for field facts, session restoration, settings,
favorites, column visibility, and the operation log. See
Local state for names and deletion
effects; macOS preferences hold appearance, text scale, update checking,
and some panel positions.
Supported systems and protocols
The application runs on macOS 14 or later. Remote hosts can use supported GNU, BSD, or BusyBox userlands over SSH. The application does not provide SMB, NFS, FTP, cloud-storage, container-management, synchronization, alerting, or Windows and Linux clients.
Use without ZFS
File browsing, file operations, the shell, preview, and favorites work without ZFS. Dataset trees and ZFS mutation commands appear only for hosts whose probe reports usable ZFS facts.
Release availability
v0.8-beta is a signed and notarized
disk image on the
releases
page. It requires macOS 14 or later and is free through
November 4, 2026.
Get the 1.0 app free with a useful beta report
Submit a useful bug report or feedback during the beta to receive the 1.0 app free. Send your report through GitHub issues. The beta runs through November 4, 2026.
Cost and license
The source is GPL-3.0. Cloning the repository and building it is free at every version. At 1.0 the built application costs US $29 once, covering 1.x updates, with no subscription, license key, or account.