# Zulip

Zulip is an open-source team messaging platform with a unique topic-based threading model.

## Dependencies

- **SMTP** - For sending invitations and notifications
- **Redis** - Used for caching and real-time event queuing

Zulip bundles its own **PostgreSQL**, **RabbitMQ**, and **Memcached** instances — these are deployed alongside the main Zulip pod and are not shared with other apps.

## Configuration

Key settings in `config.yaml`:

- **domain** - Where Zulip will be accessible
- **adminEmail** - Admin account email (defaults to your operator email)
- **smtp** - Email settings inherited from your Wild Cloud SMTP service

## First-Time Setup

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

2. **First start takes 5–10 minutes** as Zulip runs hundreds of Django database migrations. Wait until the pod shows `1/1 Running`.

3. The admin account is pre-configured with the `adminEmail` and `adminPassword` from `secrets.yaml`. Visit the app URL and log in.

4. Complete the realm (organization) setup wizard on first login.

## Inviting Users

Send invitation emails from **Settings → Organization → Invitations**, or use pre-generated invite links.

## Notes

- The `secretKey`, `postgresPassword`, and `rabbitmqPassword` are all auto-generated in `secrets.yaml`
- Zulip's topic-based threading keeps conversations organized — each stream (channel) has multiple topics
- Mobile and desktop apps are available and connect to self-hosted instances