DOCUMENTATION

Start here with Astra Shell.

The documentation is organized around everyday use, core concepts, deployment, and reference material. Begin with your first connection or jump directly to a technical topic.

Choose a path

First timeMake your first connection

Start by obtaining the server source, add a host, and open a shell.

Understand the systemFrom PTY to client screen

See how authoritative state, replicas, and multi-device access fit together.

Plan a deploymentChoose single-user or multi-user mode

Review process boundaries, privileges, quotas, and operations.

Documentation map

Everyday use

Hosts and credentials · Shells across devices · Browse and transfer files

Core concepts

Architecture · Terminal State v2 · History and scrolling · Input lease

Deployment and operations

Rootless deployment · Managed deployment · Security and quotas

Reference

Protocol compatibility · Current boundaries · FAQ

Product status

The macOS website release is now 1.2 (Build 6). The current iPhone/iPad App Store version is 1.1; version 1.2 is being prepared and has not been submitted for review. Version 1.2 uses Quinn by default and enables DATAGRAM terminal updates when the server negotiates all required capabilities, retaining reliable compatibility with older servers. Cross-platform clients, parts of network validation, and production governance remain in development.