skills.rest
decocms
decocmsOFFICIAL
Explore all skills by this author →
Website𝕏@deco_cmsGitHub

self-host-studio

Install and configure deco Studio on local or Kubernetes infrastructure.

396|51|Updated Mar 14, 2025
Search Tags:#deployment#troubleshooting#postgresql#kubernetes#helm#self-hosting#deco studio
One-click install
npx skills add https://github.com/decocms/studio --skill self-host-studio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-host-studio
Source: https://github.com/decocms/studio/tree/main/selfhost/skills/self-host-studio
Command: npx skills add https://github.com/decocms/studio --skill self-host-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users install, configure, and verify deco Studio on their own infrastructure instead of relying on a managed deployment. It reduces the risk of broken installs by guiding environment detection, dependency choices, secrets handling, and post-install validation.

Core Features & Use Cases

  • Environment-aware installation: Detects whether the target is local Docker, local Kubernetes, or production Kubernetes and selects the right deployment path.
  • Dependency wiring: Configures required services such as PostgreSQL and object storage, plus optional NATS, ClickHouse, and sandbox components when needed.
  • Operational verification: Validates that pods are running, the UI is reachable, and signup works so the installation is not just applied but confirmed.
  • Troubleshooting and recovery: Addresses common failure modes such as storage classes, architecture mismatches, missing secrets, sandbox RBAC issues, and monitoring setup problems.
  • Use Case: An engineering team wants to run Studio on their own cluster with SSO-ready infrastructure, managed databases, and optional sandbox previews, and needs a reliable step-by-step install process.

Quick Start

Ask the AI to help you self-host deco Studio on your chosen environment and guide you through configuration, installation, and verification.

Frequently Asked Questions about self-host-studio

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I self-host deco Studio on Kubernetes using Helm?▼

Self-hosting deco Studio on Kubernetes involves configuring the Helm chart, managing secrets, and wiring dependencies like PostgreSQL and object storage before verifying that pods and UI are reachable.

Do I need PostgreSQL and object storage configured before deploying deco Studio?▼

You need PostgreSQL and object storage configured as required dependencies for deploying deco Studio, while NATS, ClickHouse, and sandbox components remain optional based on your infrastructure needs.

How does environment detection work for local Docker versus production Kubernetes deployments?▼

Environment detection checks the target infrastructure to determine if it is local Docker, local Kubernetes, or production Kubernetes, selecting the correct deployment path and configuration for deco Studio.

What is the best way to troubleshoot broken sandbox RBAC issues in a deco Studio deployment?▼

Troubleshooting sandbox RBAC issues in deco Studio deployments involves diagnosing missing secrets, storage class configurations, and architecture mismatches identified during the post-install verification process.

Why does my deco Studio installation fail with architecture mismatches and missing secrets?▼

Deco Studio installations fail with architecture mismatches and missing secrets when environment detection is incomplete or Helm chart configurations do not align with your Kubernetes infrastructure.

Related Skills

Explore More Software Engineering Skills→
platxaplatxa
4

platxa-k8s-ops

Automate Kubernetes operations for the Platxa platform using Helm.

Official
Advanced
MinBZKMinBZK
20

check-deployment

Verify RIG preview deployment health during PR reviews.

Official
Intermediate
JonathanMitchell1234JonathanMitchell1234

kubernetes-expert

Manage Kubernetes clusters, deployments, networking, and production operations.

Community
Advanced
vertivolatamvertivolatam
1

OVHCloud Backend Deployment

Deploy Flutter backends on OVHCloud with managed Kubernetes and PostgreSQL.

Official
Intermediate