Fork of nextcloud/ocsms — the original was abandoned in 2020 (max NC 20). This fork brings full compatibility with Nextcloud 25 through 33, adds bidirectional SMS: read and send SMS from Nextcloud, and integrates UnifiedPush via ntfy for near-instant delivery without Google.

Android companion app → brisferr/ncsms-android

cd /var/www/html/custom_apps/
git clone https://github.com/Brisferr/ocsms.git
sudo -u www-data php occ app:enable ocsms

docker cp ocsms/ nextcloud:/var/www/html/custom_apps/
docker exec --user www-data nextcloud php occ app:enable ocsms

Add to your docker compose:

services:
  ntfy:
    image: binwiederhier/ntfy:latest
    container_name: ntfy
    command: serve
    environment:
      VIRTUAL_HOST: push.example.com
      VIRTUAL_PORT: "80"
      LETSENCRYPT_HOST: push.example.com
    volumes:
      - ./ntfy/config:/etc/ntfy
      - ./ntfy/data:/var/lib/ntfy
    restart: unless-stopped

# ntfy/config/server.yml
base-url: https://push.example.com
cache-file: /var/lib/ntfy/cache.db
auth-file: /var/lib/ntfy/auth.db
auth-default-access: deny-all
behind-proxy: true

Create a user and allow anonymous write to UnifiedPush topics:

docker exec -e NTFY_PASSWORD=yourpassword ntfy ntfy user add --role=admin youruser
docker exec ntfy ntfy access '*' 'up*' write-only

Security note: write-only for up* topics means anyone who knows the random topic URL can publish a wake-up signal — they cannot read anything, and the worst outcome is a spurious (harmless) poll of Nextcloud. For stricter setups, store ntfy credentials in PushNotifier.php.

Install as above. No additional configuration needed — the app auto-discovers registered devices.

Install ncsms-android and follow its setup guide.

Browser (compose bar)
    │  POST /front-api/v1/send
    ▼
oc_ocsms_sendmessage_queue  (status: pending)
    │  PushNotifier POSTs to ntfy endpoint
    ▼
ntfy  ──UnifiedPush──►  ncsms-android  ──SMS──►  carrier
    │
    ├─ OutboxWorker marks sent
    ├─ SyncWorker uploads SMS archive  (sent message visible in conversation)
    └─ purgeSentQueue removes it from outbox  (no duplicate)

Incoming replies trigger an immediate sync via SmsReceiver (Android broadcast on SMS_RECEIVED).

Issues and PRs welcome. This fork targets self-hosted, privacy-first setups.

AGPL-3.0 — Original authors: Loic Blot and contributors.
NC33 compatibility + send features: brisferr.
Twemoji: MIT (code) / CC-BY 4.0 (graphics). libphonenumber-for-php: Apache 2.0.