[Self-hosted] Realtime crashes with "Missing channels" + fatal Swoole\Server::exist() TypeError when

I'm unable to use the realtime connection on the latest appwrite client (npm)

When connecting to realtime it's getting stuck in a loop

browser prints: Realtime disconnected. Re-connecting in 1 seconds.
Server prints:
Connection open (user: 707)
[Error] Type: Appwrite\Extend\Exception
[Error] Message: Missing channels
[Error] File: /usr/src/code/app/realtime.php
[Error] Line: 705
Connection close: 707

Fatal error: Uncaught TypeError: Swoole\Server::exist(): Argument #1 ($fd) must be of type int, array given
in /usr/src/code/vendor/utopia-php/websocket/src/WebSocket/Adapter/Swoole.php:54

  import { Account, Channel, Client, Realtime, TablesDB } from "appwrite";

  const client = new Client()
    .setEndpoint(APPWRITE_ENDPOINT)
    .setProject(APPWRITE_PROJECT_ID);
                                                                                                                                                                                        
  const realtime = new Realtime(client);
                                                                                                                                                                                        
  realtime.onOpen(() => {                                                                                                                                                             
    console.log("Realtime connection opened"); // fires, then immediately drops
  });

  realtime.subscribe(
    Channel.tablesdb(DATABASE_ID).table(COLLECTION_ID),
    (event) => {                                                                                                                                                                        
      console.log("Realtime event:", event);
    },                                                                
  );   ```

  When downgrading the SDK to appwrite@24.2.0 it's able to connect to realtime without any issues.

the SDK follow the Cloud appwrite versions which is 1.9.2, tho the self hosted latest is 1.9.0, iirc 1.9.0 correspond to the SDK appwrite@23

Yep just found that out from a other post about the self hosted release not being up to date yet

I wonder why the self hosted isn't up to date

they release on Cloud, check if it's working correctly, if the version works correctly after X time, they release it into a stable self-hosted release

it's too avoid possible bugs in self hosted,
tho true, a better open source setup would be for appwrite to use directly the github repo for their cloud, but i don't think they will do that

(most self hosted / open source projects, have the public CE that they use as a submodule for their private cloud version, or the other way around, public CE with a private EE submodule in the public repo)

But that would cause issues like this where they are not synced in versions?

Like what i'm facing

yes,
tho i'm kinda hoping they would add tagged versions to says tag app-1.9.0 (or maybe even latest-sh) points to appwrite@23 and not latest so it's way easier for us to see the compatibility

The following happened to me, and I’m wondering if it’s related to this issue:
Over the weekend, I updated my self-hosted Appwrite instance from 1.8.1 to 1.9.0. After logging back in via the browser, I started testing and noticed that Realtime was no longer working reliably on my clients. A look at the appwrite-realtime logs revealed many entries like this:

appwrite-realtime | 2026-06-29T07:50:51.470457242Z Fatal error: Uncaught TypeError: Swoole\Server::exist(): Argument #1 ($fd) must be of type int, array given in /usr/src/code/vendor/utopia-php/websocket/src/WebSocket/Adapter/Swoole.php:54
appwrite-realtime | 2026-06-29T07:50:51.470471393Z Stack trace:
...

Naturally, I initially looked for the source of the problem on the client side and upgraded the SDK there. However, it appears that the browser console is what's triggering the messages. As soon as I log in and open a project, the log starts throwing errors. Once I close the browser tab, the log goes quiet again.

1. Is there anything I can do to downgrade the console?
2. I suspect that using the console—and the resulting fatal error—is negatively affecting existing realtime connections. Is that correct?
3. The upgrade process itself didn't go smoothly; I had to restart it a few times. I also encountered an issue where the "appwrite-worker-executions" section was missing from the docker-compose file. Could there be anything else missing or outdated in my docker-compose file that might be causing the realtime issue?

Best regards

Could you tell me if :

• The errors your seeing are from the console UI or your website directly (that use the appwrite SDK) ?
• What SDK version are you using ? (you can check with https://appwrite.io/docs/advanced/self-hosting/installation#sdk-version-compatibility if it's the right one)

Also regarding missing containers, the 1.9.0 is missing the worker-executions, the task-interval and the worker-screenshots (last one is for sites only)

Of course. The errors are from the console UI. My clients (flutter and .net) all use a version for appwrite 1.9.0, not 1.9.1 or higher, and do not trigger the errors.

OK thx, then ye might be the console version, which one are you using in the compose?

appwrite-console:
<<: *x-logging
container_name: appwrite-console
image: appwrite/console:7.8.26
restart: unless-stopped
networks:
- appwrite
labels:
- "traefik.enable=true"
- "traefik.constraint-label-stack=appwrite"
- "traefik.docker.network=appwrite"
- "traefik.http.services.appwrite_console.loadbalancer.server.port=80"
#ws
- traefik.http.routers.appwrite_console_http.entrypoints=appwrite_web
- traefik.http.routers.appwrite_console_http.rule=PathPrefix(/console)
- traefik.http.routers.appwrite_console_http.service=appwrite_console
# wss
- traefik.http.routers.appwrite_console_https.entrypoints=appwrite_websecure
- traefik.http.routers.appwrite_console_https.rule=PathPrefix(/console)
- traefik.http.routers.appwrite_console_https.service=appwrite_console
- traefik.http.routers.appwrite_console_https.tls=true

you could try using version 7.8.37, tho don't think it will fix it

else maybe migrate to appwrite 1.9.5 since it's released

Thanks, will do