Chapter 20. Creating a site on local systems using YAML


Using YAML allows you to create and manage sites on Docker, Podman and Linux.

A typical workflow is to create a site, link sites together, and expose services to the application network.

If you require more than one site, specify a unique namespace when using skupper, for example skupper --namespace second-site ....

You can use YAML to create and manage Skupper sites.

Prerequisites

  • The skupper CLI is installed.

There are many options to consider when creating sites using YAML, see YAML Reference, including frequently used options.

Procedure

  1. Create a site CR YAML file named my-site.yaml in an empty directory, for example, local:

    apiVersion: skupper.io/v2alpha1
    kind: Site
    metadata:
      name: my-site

    This YAML creates a site named my-site in the default namespace.

  2. Create the site:

    skupper system setup --path ./local

    Skupper attempts to process any files in the local directory. Typically, you create all resources you require for a site before running skupper system setup.

    Optional: Enable the Dynamic System Controller to automatically process YAML resources:

    export SKUPPER_SYSTEM_RELOAD_TYPE=auto
    skupper system install

    With this feature enabled, you can create sites, links, connectors and listeners without needing a system reload to apply your configuration.

  3. Check the status of the site:

    skupper site status

    You might need to issue the command multiple times before the site is ready:

    NAME    STATUS  MESSAGE
    default Ready   OK

    You can now link this site to another site to create an application network.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top