Documentation

Guides for the open-source Human Application Layer—setup, mail, security, workspaces, APIs, and troubleshooting. Same software whether you self-host or run Hosted HAL.

New to the product story? Read the HAL manifesto · License.

Need Help? Ask Our AI Assistant

Click the chat icon in the bottom right corner to get instant answers. Our AI assistant can help with setup, troubleshooting, and account-specific questions.

Getting Started

New to HAL? Create an account, add your first domain, and send your first message from the Human Application Layer.

QuickstartHALSetup

Custom app domain

Use your own hostname (e.g. app.yourcompany.com) for the Annex Orbis app. Add CNAME + TXT at any DNS provider, then verify in settings.

White-labelCNAMEDNSBranding

Domain setup (email)

Configure mail domains with annexorbis. Step-by-step guides for DNS verification including MX, SPF, DKIM, and DMARC records.

DNSVerificationSPFDKIM

Email Accounts

Create and manage email accounts. Learn about signatures, auto-reply, forwarding rules, and sharing email access with team members.

CreateManageForwardingSharing

Security & Privacy

Understand how AnnexOrbis protects your emails with end-to-end encryption. Learn about recovery keys, 2FA, and security best practices.

E2EEEncryption2FAPrivacy

Workspaces & Teams

Collaborate with your team using workspaces. Invite members, assign roles, and manage shared email accounts.

TeamsCollaborationRoles

Agents

Where an agent can run, connecting an outsourced agent with one API key, powers and approvals, and when a mailbox key is required.

AgentsAutomationAPI

Encryption Tiers

Open vs. end-to-end encrypted mailboxes — what each tier allows, and which one agents and API keys can use.

SecurityEncryptionMailboxes

eSign

Prepare multi-PDF envelopes, place fields, use templates and PowerForms, bulk send, host kiosk signing, and download audit certificates.

SignaturesTemplatesAuditEnvelopes

API Keys

Send emails programmatically using API keys with SMTP. Learn how to create keys, configure your app, and monitor usage.

SMTPIntegrationAutomation

SMS Consent API

Record an affirmative SMS opt-in from your own website. Covers the number registration your sending line needs first, what consent evidence is stored, and what you are warranting.

SMSConsentTCPAIntegration

Troubleshooting

Solutions to common issues. DNS verification problems, email delivery issues, encryption errors, and more.

IssuesSolutionsHelp

FAQ

Frequently asked questions about AnnexOrbis, organized by category. Quick answers to common questions.

QuestionsAnswers