Install on a Mac

What you need

• A Mac with Apple silicon (M1 or later) running macOS 15 or newer.
• About 1 GB of free disk space for the app, plus room for your brands' media.
• A Postiz server for publishing, and keys for the services you route tasks to. You add these in BRANDA after installing.

BRANDA carries its own runtime, database and browser. You don't install anything with Homebrew or Terminal.

Install

1. Download BRANDA and open the disk image.
2. Drag BRANDA to Applications.
3. Open BRANDA from Applications.

The app is signed with an Apple Developer ID and notarized by Apple, so macOS opens it without a warning.

First launch

On first launch BRANDA creates its folders, sets up its database and opens the workspace in its own window. There's no sign-in.

BRANDA's web service, worker, database and nightly maintenance run as login items. You see them in System Settings → General → Login Items. Quitting the app keeps them running, so scheduled work carries on. Closing the window hides it; click BRANDA in the Dock to bring it back.

Add your keys

Open Settings → Connections & API keys. Paste the Postiz address and API key, then Save Postiz connection. Other provider keys go in the same section. Keys go straight to the macOS Keychain and BRANDA never shows them again. Saving a key doesn't contact the provider, spend money or publish anything.

Where things live

• Data: ~/Library/Application Support/BRANDA/ (database, settings export, media, backups)
• Logs: ~/Library/Logs/BRANDA/

Each company runs its own installation.