Skip to content

Docs: simple guides for daily use

Start with the basics. Command examples are included when you need them.

1. Download from the official source

Use the GitHub Releases page to get the latest official version.

$ open https://github.com/moaiy-com/moaiy/releases
Open Releases

2. Create your key pair

Do this once, then store your private key in a safe place.

$ moaiy key generate

3. Encrypt a file

Choose recipient mode or password mode based on your sharing needs.

$ moaiy encrypt secret.txt --recipient [email protected]
$ moaiy encrypt secret.txt --password

4. Decrypt and verify

Decrypt files and verify checksums before installing downloads.

$ moaiy decrypt secret.txt.gpg
Read verification guide

Build from source (optional)

git clone https://github.com/moaiy-com/moaiy.git
cd moaiy
open Moaiy/Moaiy.xcodeproj
xcodebuild -project Moaiy/Moaiy.xcodeproj -scheme Moaiy -destination 'platform=macOS' build

Smartcard and hardware token notes

If you use an OpenPGP smart card or hardware token, keep private key material on hardware when possible and test your unlock flow before relying on it for daily work.

Use this guide for practical setup patterns, backup planning, and recovery checks: Smartcard encryption guide.

What is Moaiy?

Moaiy is a free, open-source app that helps you encrypt files on macOS.

How do I download safely?

Download from official GitHub Releases and verify checksums before opening the file.

Does Moaiy upload unencrypted files?

Moaiy is designed for local encryption on your Mac. See the security page for details.