Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 13. Creating a site on a local system using the Skupper CLI

Using the skupper command-line interface (CLI) allows you to create and manage Skupper sites from the context of the current user.

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

A local system includes Docker, Podman or Linux system.

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

13.1. Checking the Skupper CLI and environment
Copy link

Installing the skupper command-line interface (CLI) provides a simple method to get started with Skupper.

  1. Follow the instructions for Installing Skupper.

  2. Verify the installation. 

    $  skupper version
COMPONENT               VERSION
cli                     {skupper_cli_version}
    Copy to Clipboard Toggle word wrap

  3. For podman sites:

    Make sure the Podman socket is available. To enable it: 

    systemctl --user enable --now podman.socket
    Copy to Clipboard Toggle word wrap

    Enable lingering to ensure the site persists over logouts: 

    loginctl enable-linger <username>
    Copy to Clipboard Toggle word wrap

Prerequisites

  • The skupper CLI is installed.

Procedure

  1. Set the SKUPPER_PLATFORM for type of site you want to install:

    • podman
    • docker
    • linux

  2. Create a site: 

    $ skupper site create <site-name>
    Copy to Clipboard Toggle word wrap

    For example: 

    $ skupper site create my-site
Waiting for status...
Site "my-site" is ready.
    Copy to Clipboard Toggle word wrap

📌 NOTE: On non-Kubernetes sites, you can create multiple sites per-user by specifying a namespace.

Prerequisites

  • The skupper CLI is installed.

Procedure

  1. Enter the following command to delete a site: 

    skupper system teardown
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

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

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

Theme

© 2025 Red Hat