43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
# 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
|