Quickstart

If OPSd is not installed yet, start with Install.

These commands assume the installed opsd command is available on your PATH. If you use a portable release bundle, replace opsd with the path to its bin/opsd executable.

This quickstart validates and renders configuration; it does not create cloud resources. Review the generated files before you continue.

1. Create Or Select A Profile

opsd config profile create work
opsd config profile use work

If you already have a profile, use opsd config profile current to verify it.

2. Inspect The Catalog

OPSD_PROFILE=work opsd list blueprints
OPSD_PROFILE=work opsd describe blueprint kubernetes-foundation

3. Initialize A Manifest

OPSD_PROFILE=work opsd init blueprint kubernetes-foundation demo.yaml --variant kubernetes

4. Validate And Render

OPSD_PROFILE=work opsd validate manifest demo.yaml
OPSD_PROFILE=work opsd render manifest demo.yaml --output live/

Optional: Render The Kubernetes Platform

For a Kubernetes manifest, synchronize its pinned module and chart sources, then render enabled platform components. Helm must be available in PATH.

OPSD_PROFILE=work opsd modules sync demo.yaml
OPSD_PROFILE=work opsd render manifest demo.yaml --output live/ --include-platform
OPSD_PROFILE=work opsd validate manifest demo.yaml --platform

Platform validation needs network access the first time so it can cache Terraform/OpenTofu providers and Kubernetes schemas. Once those caches are warmed, add --offline to validate without network access.

5. Hand Off To OpenTofu

cd live
tofu init -backend=false -input=false
tofu validate

If you are using a workspace, set OPSD_WORKSPACE_ROOT to the directory that contains modules/<provider>/* before running the commands above.

Next Step: Create the Environment

After reviewing the rendered configuration, follow the Kubernetes Deployment Walkthrough to apply the cloud foundation and complete the first platform setup.