Install on ZimaOS

Import OpenPost as a ZimaOS custom app with the supplied Compose file. The image supports x86_64 devices. Other architectures need amd64 emulation.

What you need

• A ZimaOS device with the App Store available.
• Its local IP address. The Compose file uses 10.0.0.1 as an example.
• A public HTTPS address before you connect social accounts.

Generate two secrets and keep them private:

openssl rand -base64 32
openssl rand -base64 32

Import the app

1. Download deploy/zimaos/docker-compose.yml.
2. Replace 10.0.0.1 with your ZimaOS device's IP address in OPENPOST_APP_URL, OPENPOST_PUBLIC_URL, and OPENPOST_MEDIA_URL.
3. Replace the two REPLACE-WITH-GENERATED-... values with the secrets you generated.
4. In ZimaOS, open the App Store and choose Custom Install → Import from the Compose file (or paste its contents).
5. Check the image, port 8080, and openpost_data volume, then install the app.
6. Open http://<your-device-ip>:8080 and create the first account. It becomes the instance administrator.

Before connecting providers

Replace the three local URLs with your public HTTPS addresses, then import the updated definition. Keep the openpost_data volume. Confirm readiness through the public address before connecting providers:

curl https://post.example.com/api/v1/ready

Update and back up

Use a versioned image tag from GitHub Releases. Before changing it, stop OpenPost and back up the openpost_data volume with the edited Compose file. Import the updated definition, then check /api/v1/ready.

Keep backups private and off the device. A rollback may require the backup made for the previous version because database migrations are not always backward compatible. See Maintenance for the restore checklist.

Next steps

• Configure integrations for your social platforms.
• Back up your instance before relying on it for scheduled posts.