Skip to content

docs: self hosting with kubernetes#2589

Open
sidpalas wants to merge 1 commit intosp/docs-refresh-3from
sp/docs-refresh-4
Open

docs: self hosting with kubernetes#2589
sidpalas wants to merge 1 commit intosp/docs-refresh-3from
sp/docs-refresh-4

Conversation

@sidpalas
Copy link
Collaborator

🧠 Ai UsageDetails (if applicable):

IMPORTANT: Please disclose any usage of ai tooling while making this change. If you did not use any AI write "NA" below

Example: Used ChatGPT to help with doc phrasing.
Example: Code generated by Copilot; reviewed and verified manually.

@sidpalas sidpalas changed the base branch from develop to sp/docs-refresh-3 February 28, 2026 02:13
title: "Remote Runs (Beta)"
---

## TODO: this needs a refresh
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mind opening up an issue for this? Happy to make a pr, an issue with the docs label would make it easier to track

Use the OpenTaco Helm charts for Kubernetes deployments:

## Coming soon
- OpenTaco umbrella chart: `self-hosting/kubernetes/helm-charts/opentaco`
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thoughts on having this as a prerequisite in a h2? Might make it easier when scanning through

kubectl create namespace traefik
```
</Step>
<Step title="Install the platform reference chart">
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we might be able to improve the experience, with a one line for obtaining the chart ? If i was trying to breeze through this i'd have to pause and go obtain the chart then come back.

Wdyt?

## Deploy OpenTaco with the umbrella chart

<Steps>
<Step title="Prepare your values file">
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thoughts on giving a quick preview on what the values file should look like? similar to
https://digger-20-sp-docs-refresh-4.mintlify.app/ce/reference/digger.yml#complete-configuration-example

Helps set up expectations


If you are using the platform reference chart (Traefik), you can check it with:

```bash
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

in trying to optimize for copy/pasting, do you think replacing the get svc command could be replaced with something like

kubectl get ingress <ingress-name> -o jsonpath='{.spec.rules[*].host}'

<Step title="Create or sync Kubernetes secrets (existing-secret path)">
If you are using existing secrets, create or sync them now, then ensure `useExistingSecret: true` and `existingSecretName` entries in `values-opentaco.yaml` match.

```bash
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thoughts on moving the commands into individal code blocks? When doing multiple command its slightly easier to break them up, that way you can use the copy button that shows up beside it

i.e this would become:

kubectl create secret generic ui-secrets \
  --from-env-file=helm-charts/secrets-example/ui.env \
  -n opentaco --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic taco-orchestrator-secrets \
  --from-env-file=helm-charts/secrets-example/digger-backend.env \
  -n opentaco --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic statesman-secrets \
  --from-env-file=helm-charts/secrets-example/statesman.env \
  -n opentaco --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic drift-secrets \
  --from-env-file=helm-charts/secrets-example/drift.env \
  -n opentaco --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic taco-sidecar-secrets \
  --from-env-file=helm-charts/secrets-example/sidecar.env \
  -n opentaco --dry-run=client -o yaml | kubectl apply -f -

@@ -0,0 +1,280 @@
# Profile-based startup guide:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is mostly a question do you think it would be worth adding a reference for the docker compose environment variables?

Copy link
Collaborator

@s1ntaxe770r s1ntaxe770r left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Solid work @sidpalas !!!, a couple comments and questions in between but thanks for the reorg!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants