DataSurface Setup Walkthrough

Guides step-by-step deployment of DataSurface Yellow on Docker Desktop via Helm and kubectl.

2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/datasurface/demo1 --skill datasurface-setup-walkthrough-datasurface
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: DataSurface Setup Walkthrough
Source: https://github.com/datasurface/demo1/tree/main/.claude/skills/setup-walkthrough
Command: npx skills add https://github.com/datasurface/demo1 --skill datasurface-setup-walkthrough-datasurface

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides administrators through a comprehensive DataSurface Yellow environment deployment on Docker Desktop, reducing setup time and potential misconfigurations.

Core Features & Use Cases

  • Pre-flight checks: validates prerequisites like Docker Desktop, Kubernetes, and required credentials.
  • End-to-end deployment: guides through PostgreSQL setup, model customization, RBAC, Airflow deployment, and bootstrap generation.
  • Quick start for hands-on deployment: provides a clear, repeatable sequence for local Docker Desktop setups.

Quick Start

Follow the step-by-step instructions to execute the setup walkthrough on your machine. Start with Step 0: Clean up previous installations, then proceed through Step 1 to Step 9 in order to deploy and verify the DataSurface environment.

Frequently Asked Questions about DataSurface Setup Walkthrough

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

FAQPage Schema
How do I deploy DataSurface on Docker Desktop?

To deploy DataSurface on Docker Desktop, execute a sequential setup covering pre-flight checks, PostgreSQL configuration, Kubernetes RBAC, Airflow deployment, and DAG generation. This structured walkthrough ensures correct environment variable validation and artifact creation.

What prerequisites do I need to set up DataSurface with Airflow and Kubernetes?

Setting up DataSurface with Airflow and Kubernetes requires Docker Desktop with Kubernetes enabled, plus required credentials. The pre-flight validation phase checks these dependencies before proceeding with PostgreSQL setup and RBAC configuration.

How do I configure Kubernetes RBAC for a local Airflow deployment?

You configure Kubernetes RBAC for local Airflow deployment by applying sequential model customization steps during the DataSurface setup. This process uses kubectl and Helm to ensure proper permissions before generating bootstrap artifacts.

Why does my DataSurface bootstrap generation fail during setup?

DataSurface bootstrap generation fails if sequential execution is interrupted or environment variables lack validation. The setup enforces strict step ordering from PostgreSQL configuration through Airflow deployment to ensure artifacts generate correctly.

What is the best way to generate DAGs for a DataSurface Yellow environment?

The best way to generate DAGs for a DataSurface Yellow environment is following the sequential deployment walkthrough. It guides you through PostgreSQL setup and Airflow deployment to produce correct DAG artifacts using Docker and Helm.

Can I use Helm and kubectl to deploy DataSurface locally?

Yes, you can use Helm and kubectl to deploy DataSurface locally on Docker Desktop. The setup walkthrough leverages these tools alongside a bootstrap generator to configure the Yellow environment and deploy DAGs.