Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 06:00 UTC
| 1 | --- |
| 2 | type: "reference" |
| 3 | title: "Self-hosted Helm" |
| 4 | description: "Public support knowledge for Self-hosted Helm." |
| 5 | category: "getting-started" |
| 6 | visibility: "public" |
| 7 | timestamp: "2026-06-24T00:00:00Z" |
| 8 | tags: |
| 9 | - "self-hosted-helm" |
| 10 | --- |
| 11 | # Self-hosted Helm |
| 12 | |
| 13 | Use this for Composio self-hosted or on-prem Helm deployment issues. |
| 14 | |
| 15 | ## Apollo S3 with IRSA / ServiceAccount credentials needs no static S3 secret keys |
| 16 | |
| 17 | For IRSA / ServiceAccount-based S3 access, `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY` should not be populated in the Apollo container. These secret keys are optional. If the keys are removed from `composio-composio-secrets`, Apollo can fall back to the configured pod ServiceAccount / AWS SDK credential chain. |
| 18 | |
| 19 | Do not set placeholder S3 credential values for IRSA deployments. Values such as `dummy-value` or a literal string `null` are treated as credentials and can make S3 pre-signed URLs fail with provider errors such as: |
| 20 | |
| 21 | ```text |
| 22 | InvalidAccessKeyId: The AWS Access Key Id you provided does not exist in our records. |
| 23 | InvalidToken: The provided token is malformed or otherwise invalid. |
| 24 | ``` |
| 25 | |
| 26 | For AWS IRSA, configure the Apollo ServiceAccount annotation and object storage backend, then leave static S3 credential secret keys absent: |
| 27 | |
| 28 | ```yaml |
| 29 | apollo: |
| 30 | serviceAccount: |
| 31 | enabled: true |
| 32 | name: "composio-apollo" |
| 33 | annotations: |
| 34 | eks.amazonaws.com/role-arn: "arn:aws:iam::<AWS_ACCOUNT_ID>:role/<IAM_ROLE_NAME>" |
| 35 | objectStorage: |
| 36 | backend: "s3" |
| 37 | ``` |
| 38 | |
| 39 | Debug checks: |
| 40 | |
| 41 | ```bash |
| 42 | kubectl exec -n composio deploy/composio-apollo -- env | grep -E "^S3_|^AWS_" |
| 43 | kubectl logs -n composio deploy/composio-apollo --tail=200 |
| 44 | ``` |
| 45 | |
| 46 | If using pod/container credentials, the Helm storage doc says the Kubernetes secret credential section can be skipped. The important support check is that `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY` are not present with dummy/static values in Apollo's runtime environment. |
| 47 | |
| 48 | Example response: |
| 49 | |
| 50 | ```text |
| 51 | This looks like Apollo is still receiving static S3 credential env vars, so the AWS SDK is using those instead of falling back to the ServiceAccount/IRSA credentials. |
| 52 | |
| 53 | For IRSA, `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY` should be absent from the Apollo container. Those secrets are optional; if you remove those keys from `composio-composio-secrets`, Apollo should use the configured ServiceAccount. Placeholder values like `dummy-value` or literal `null` are treated as real credentials and can cause S3 signing errors such as `InvalidAccessKeyId` or `InvalidToken`. |
| 54 | |
| 55 | The immediate fix is to remove `S3_ACCESS_KEY_ID` and `S3_SECRET_ACCESS_KEY` from `composio-composio-secrets`, then confirm the Apollo pod environment no longer includes those values. |
| 56 | ``` |
| 57 | |
| 58 | ## Disable social login explicitly for self-hosted deployments |
| 59 | |
| 60 | `NEXT_PUBLIC_DISABLE_SOCIAL_LOGIN` controls whether social login buttons such as Google/GitHub appear on the frontend login page. For self-hosted customers that should hide social login, set the Helm values override as a string: |
| 61 | |
| 62 | ```yaml |
| 63 | apollo: |
| 64 | nextPublicDisableSocialLogin: "true" |
| 65 | ``` |
| 66 | |
| 67 | This makes the generated Apollo ConfigMap render an explicit value instead of an empty/null value and should remove repeated ArgoCD diffs immediately. |
| 68 | |
| 69 | Customers can apply the override directly to unblock the deployment. |
| 70 | |
| 71 | Example response: |
| 72 | |
| 73 | ~~~text |
| 74 | `NEXT_PUBLIC_DISABLE_SOCIAL_LOGIN` controls whether the Google/GitHub social login buttons show up on the frontend login page. For your setup, I'd set it explicitly to `"true"` in the Helm values override: |
| 75 | |
| 76 | ```yaml |
| 77 | apollo: |
| 78 | nextPublicDisableSocialLogin: "true" |
| 79 | ``` |
| 80 | |
| 81 | This should make the generated Apollo ConfigMap render the explicit value and stop ArgoCD from diffing null vs empty string immediately. |
| 82 | |
| 83 | The override above can be applied directly; no release-specific promise is required. |
| 84 | ~~~ |