# Gancio

Gancio is a shared agenda for local communities, federated via ActivityPub. It allows groups to publish and discover local events.

## Dependencies

- **PostgreSQL** - Database for storing events and users

## Configuration

Key settings in `config.yaml`:

- **domain** - Where Gancio will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **db.name** - Database name (default: `gancio`)

## First-Time Setup

1. Add and deploy the app:
   ```bash
   wild app add gancio
   wild app deploy gancio
   ```

2. Visit the app URL — on first load, a setup wizard will run to create the admin account and configure the instance.

3. After setup, you can start publishing events and inviting community members.

## Notes

- **Re-deploy warning**: If the app is deleted and redeployed with an existing database, Gancio will refuse to start with a "Non empty db" error. See `gancio/notes.md` for the fix.
- Gancio stores its setup state in `config.json` on the data PVC — do not delete the PVC without also clearing the database
- Events are federated to Mastodon and other ActivityPub platforms