Skip to content

docs(academy): add notify_push to local-Nextcloud tutorial#28

Merged
rubenvdlinde merged 1 commit into
developmentfrom
docs/academy-notify-push
May 9, 2026
Merged

docs(academy): add notify_push to local-Nextcloud tutorial#28
rubenvdlinde merged 1 commit into
developmentfrom
docs/academy-notify-push

Conversation

@rubenvdlinde
Copy link
Copy Markdown
Collaborator

Summary

OpenRegister's add-live-updates change and the matching `@conduction/nextcloud-vue@1.0.0-beta.4` plugin both rely on `notify_push` being available. The default "Nextcloud lokaal draaien" tutorial currently shows a 3-service compose (db + redis + nextcloud), so anyone following it ends up on polling.

This PR brings the tutorial up to par by adding the `notify_push` Rust sidecar and the one-time `occ` setup steps so the stack is push-ready out of the box.

Changes

  • docker-compose.yml snippet — adds `notify_push` service (`icewind1991/notify_push:latest` on :7867, depends on db + redis + nextcloud, mounts NC volume RO, reads `REDIS_URL` + `DATABASE_URL` + `NEXTCLOUD_URL`).
  • New Stap 5 — five `occ config:system:set` commands (Redis host/port, `memcache.distributed`, trusted_proxies subnet) plus `notify_push:setup http://notify_push:7867` and `notify_push:self-test`. Walked through with expected check-mark output.
  • Outcomes — now mentions `notify_push` as the realtime channel.
  • Troubleshooting — two new entries: `trusted_proxies` subnet mismatch, and the "No redis server is configured" restart loop.

Verification

I ran every command in this PR against a fresh local stack today; `notify_push:self-test` passes all six checks (expected `unencrypted http` warning aside).

Related

  • openregister#1453 — backend (NotifyPushListener, PushEvents, admin status section, OR-side push docs)
  • nextcloud-vue#144 — frontend plugin (merged, published as 1.0.0-beta.4)

OpenRegister's add-live-updates change (PR #1453) and the matching
@conduction/nextcloud-vue@1.0.0-beta.4 plugin both rely on
notify_push being available. Updating the canonical "Nextcloud lokaal
draaien" tutorial so anyone who follows it gets a stack ready for
realtime push out of the box, not just polling.

Adds:
- notify_push service to docker-compose (icewind1991/notify_push:latest,
  port 7867, depends on db + redis + nextcloud, mounts NC volume RO,
  reads REDIS_URL + DATABASE_URL + NEXTCLOUD_URL)
- New Stap 5 with the five occ config:system:set commands needed to
  wire NC's Redis cache, mark the Docker subnet as a trusted proxy,
  and run notify_push:setup
- Self-test step with expected check-mark output
- Two troubleshooting entries: trusted_proxies subnet mismatch, and
  the "No redis server is configured" restart loop

Outcomes section now mentions notify_push as the realtime channel.
@rubenvdlinde rubenvdlinde merged commit 10be27f into development May 9, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant