> ## Documentation Index
> Fetch the complete documentation index at: https://libops-renovate-github-com-libops-sitectl-0-x.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# create

> Create a new stack from an installed plugin definition.

export const Compose = () => <Tooltip headline="Compose" tip={<>
        Docker Compose is Docker's tool for defining and running multi-container applications.{" "}
        <a href="https://docs.docker.com/compose/">https://docs.docker.com/compose/</a>.
      </>}>
    <>
      <Icon icon="docker" />
      {" "}
      Compose
    </>
  </Tooltip>;

The `create` command provisions a new <Compose /> stack using a create definition registered by an installed plugin. Run `sitectl create list` to see all available definitions, or omit arguments to be guided interactively.

## Reference

Create a new stack using a first-class create definition registered by an installed sitectl plugin.

```bash theme={null}
sitectl create [plugin[/definition]] [args...]
```

## Selecting a definition

You can qualify the target as `plugin/definition` to skip prompts entirely:

```bash theme={null}
sitectl create isle/default
sitectl create drupal/default
```

Or just pass a definition name when it is unambiguous across installed plugins:

```bash theme={null}
sitectl create default
```

## Flag ordering

`create` forwards everything after it to the selected plugin's create runner, so it
does not parse flags itself. Global `sitectl` flags such as `--context` and
`--log-level` must therefore come **before** the `create` subcommand:

```bash theme={null}
# correct: global flags before `create`, create flags after
sitectl --context staging create drupal/default \
  --path ./drupal --type local --checkout-source template --setup-only
```

Putting a global flag after `create` forwards it to the plugin, which rejects it:

```bash theme={null}
# wrong: --context is forwarded to the plugin
sitectl create drupal/default --path ./drupal --context staging
# Error: unknown flag: --context
```

Plugin-specific create flags (for example `--path`, `--type`, `--checkout-source`,
`--setup-only`, or ISLE's `--fcrepo` and `--blazegraph`) still go after the target,
because they belong to the plugin's create runner.