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.