Troubleshooting

This page collects common failure modes and the corresponding rstream error messages. It focuses on issues that occur during CLI runtime resolution and during signaling connections.

Missing engine

Commands that operate on the data plane require an engine endpoint. When the engine is missing, the CLI returns an error indicating that an engine must be provided through a flag, an environment variable, or a selected context.

Missing token

Commands that require authentication fail when no token is available. In hosted workflows this is typically resolved by running rstream login. In project-scoped workflows this is resolved by providing a project-scoped token through a context or environment variables.

Expired token

When the CLI can decode the JWT expiration claim, it checks token expiration and returns an error when the token is expired.

Invalid signaling transport

The watch and events helpers accept sse and websocket transport values. Invalid values return a transport validation error.