Support

Getting started

Actuali connects to an Actual Budget server you host yourself. Enter your server URL and password in the app's More tab to sync your budget. No server yet? Open More and tap "Try the demo budget"to explore every feature offline with sample data.

Common questions

• Do I need my own server? Yes — Actuali is a companion client for Actual Budget. Sync requires the Actual server you host. The demo budget works without one.
• Where is my data? Your budget lives locally on your device and syncs only to the server you configure. Nothing is sent to the developer. See the privacy policy.
• Does it work offline? Yes. Record transactions any time; they sync back when you reconnect.
• Where are backups stored, and how do I export them?Backups are stored locally in Actuali's private app storage on your device. A backup is created automatically every time you leave the app, and you can also tap Back Up Now anytime in Connection & Data. To export a backup to the Files app (iCloud Drive or local storage), AirDrop it to your computer, or import it into Actual on desktop/web, openMore → Connection & Data → Backups and tap Export. See the Backups & Export guide.
• How do I disconnect? Tap "Disconnect" in More to clear the local session and stored credentials.

Trouble connecting?

Start here: open your server address in Safari on the same iPhone. Whatever Safari says is almost always the real problem — if Safari can't load it, or warns you the connection isn't private, Actuali won't be able to connect either.

• "Couldn't make a secure connection" / "TLS error" — iPhones only connect to servers with a security certificate they trust, and won't let an app skip that check. If your server uses a certificate it generated itself, iOS blocks the connection. Most self-hosting setups can issue a free trusted certificate automatically — tools like Caddy, Nginx Proxy Manager and Cloudflare Tunnel all do this for you. Once Safari loads your server without a warning, Actuali will connect.
• "Your server's security certificate has expired" — certificates need renewing periodically. Renew it on the server and try again.
• "Couldn't reach your server" — if it works at home but not out and about, your server is only reachable on your home network. You'll need a VPN back home, or to make the server available over the internet, to sync while away.
• "Couldn't find a server at that address" — check the address for typos, and include the port number if your server uses one (for example https://budget.example.com:5006).
• "Forbidden" or a 403 error when logging in — usually something sitting in front of your server is blocking the app. If you've restricted access to certain networks or addresses, your phone may not be on the allowed list. If you use a login gateway such as Cloudflare Access or Authelia, add its credentials underCustom HTTP headers in Actuali's More tab.

Still stuck? Emailactuali@mfazz.com with the exact message the app shows and we'll help.

Open source

Actuali is open source. Browse the code, report issues, or contribute on GitHub.

Contact

Found a bug or need help? Email actuali@mfazz.com and we'll get back to you.