This note is in Hasura.Server.Init.
It is referenced at:
ReadOnly Mode
This mode starts the server in a (database) read-only mode. That is, only
read-only queries are allowed on users’ database sources, and write
queries throw a runtime error. The use-case is for failsafe operations.
Metadata APIs are also disabled.
Following is the precise behaviour -
- For any GraphQL API (relay/hasura; http/websocket) - disable execution of
mutations
- Metadata API is disabled
- /v2/query API - insert, delete, update, run_sql are disabled
- /v1/query API - insert, delete, update, run_sql are disabled
- No source catalog migrations are run
- During build schema cache phase, building event triggers are disabled (as
they create corresponding database triggers)