Skip to content

Commit c0469a5

Browse files
committed
docs(self-hosting): drop retired v3 graphile worker and coordinator/provider references
1 parent 0780375 commit c0469a5

3 files changed

Lines changed: 2 additions & 10 deletions

File tree

docs/self-hosting/docker.mdx

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -390,8 +390,6 @@ See the [webapp environment variables](/self-hosting/env/webapp) for the full li
390390
docker compose logs -f webapp
391391
```
392392
393-
- **Deploy fails with `ERROR: schema "graphile_worker" does not exist`.** This error occurs when Graphile Worker migrations fail to run during webapp startup. Check the webapp logs for certificate-related errors like `self-signed certificate in certificate chain`. This is often caused by PostgreSQL SSL certificate issues when using an external PostgreSQL instance with SSL enabled. Ensure that both the webapp and supervisor containers have access to the same CA certificate used by your PostgreSQL instance. You can configure this by mounting the certificate file and setting the `NODE_EXTRA_CA_CERTS` environment variable to point to the certificate path. Once the certificate issue is resolved, the migrations will complete and create the required `graphile_worker` schema.
394-
395393
- **ClickHouse migrations say "no migrations to run" but schema is missing.** The goose migration tracker is out of sync. Exec into the webapp container, set the GOOSE env vars (from webapp startup logs), and run `goose reset && goose up`.
396394
397395
<Warning>

docs/self-hosting/env/webapp.mdx

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -52,11 +52,8 @@ mode: "wide"
5252
| `AWS_REGION` | No || AWS region for SES. |
5353
| `AWS_ACCESS_KEY_ID` | No || AWS access key ID for SES. |
5454
| `AWS_SECRET_ACCESS_KEY` | No || AWS secret access key for SES. |
55-
| **Graphile & Redis worker** | | | |
56-
| `WORKER_CONCURRENCY` | No | 10 | Redis worker concurrency. |
57-
| `WORKER_POLL_INTERVAL` | No | 1000 | Redis worker poll interval (ms). |
58-
| `WORKER_SCHEMA` | No | graphile_worker | Graphile worker schema. |
59-
| `GRACEFUL_SHUTDOWN_TIMEOUT` | No | 60000 (1m) | Graphile graceful shutdown timeout (ms). Affects shutdown time. |
55+
| **Worker** | | | |
56+
| `GRACEFUL_SHUTDOWN_TIMEOUT` | No | 60000 (1m) | Graceful shutdown timeout (ms). Affects shutdown time. |
6057
| **Concurrency limits** | | | |
6158
| `DEFAULT_ENV_EXECUTION_CONCURRENCY_LIMIT` | No | 100 | Default env execution concurrency. |
6259
| `DEFAULT_ORG_EXECUTION_CONCURRENCY_LIMIT` | No | 300 | Default org execution concurrency, needs to be 3x env concurrency. |
@@ -168,8 +165,6 @@ mode: "wide"
168165
| `MAXIMUM_DEV_QUEUE_SIZE` | No || Maximum queued runs per queue in development environments. |
169166
| `MAXIMUM_DEPLOYED_QUEUE_SIZE` | No || Maximum queued runs per queue in deployed (staging/prod) environments. |
170167
| **Misc** | | | |
171-
| `PROVIDER_SECRET` | No | provider-secret | Secret for provider auth. **Must be set to a secure value in self-hosted/production**; the default is insecure. |
172-
| `COORDINATOR_SECRET` | No | coordinator-secret | Secret for coordinator auth. **Must be set to a secure value in self-hosted/production**; the default is insecure. |
173168
| `TRIGGER_TELEMETRY_DISABLED` | No || Disable telemetry. |
174169
| `NODE_MAX_OLD_SPACE_SIZE` | No | 8192 | Maximum memory allocation for Node.js heap in MiB (e.g. "4096" for 4GB). |
175170
| `OPENAI_API_KEY` | No || OpenAI API key. |

docs/self-hosting/kubernetes.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -602,7 +602,6 @@ kubectl delete namespace trigger
602602
- **Deploy fails**: Verify registry access and authentication
603603
- **Pods stuck pending**: Describe the pod and check the events
604604
- **Worker token issues**: Check webapp and supervisor logs for errors
605-
- **Deploy fails with `ERROR: schema "graphile_worker" does not exist`**: See the [Docker troubleshooting](/self-hosting/docker#troubleshooting) section for details on resolving PostgreSQL SSL certificate issues that prevent Graphile Worker migrations.
606605

607606
See the [Docker troubleshooting](/self-hosting/docker#troubleshooting) section for more information.
608607

0 commit comments

Comments
 (0)