---
name: "plainbox-startprovider"
section: "1"
platform: "linux"
package: "plainbox"
version: "0.25-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/plainbox-startprovider"
---

# plainbox-startprovider(1)

create a new plainbox provider

## NAME

plainbox-startprovider - create a new plainbox provider

## SYNOPSIS

```
plainbox startprovider [-h] [--empty] name
```

## DESCRIPTION

Creates a new provider from a built-in skeleton.

The name of the provider must follow the pattern \`\`YYYY.example.org:name\`\` where \`\`YYYY\`\` is a four-digit year when the author of the provider owned the domain (here, \`\`example.org\`\`) and \`\`name\`\` is arbitrary identifier that is managed by the owner of that domain. The identifier should be constrained to ASCII, digits and the dash character.

This naming scheme allows anyone that ever owned a domain name to come up with non-clashing provider identifiers. Those identifiers are going to be used in fully qualified names of various objects.

This command creates a new skeleton test provider for PlainBox. The generated content should be edited to fit a particular purpose.

## OPTIONS

**Positional arguments:**

- **provider name, eg: YYYY.example.org:some-name**

  **Optional arguments:**

- **--empty**

  create an empty provider

## ABOUT NAMING PROVIDERS

Plainbox tries to be intuitive where possible but provider names keep causing issues and make people struggle with coming up with correct and good names. See **plainbox-provider-names** for a detailed discussion of provider names.

## AUTHOR

Zygmunt Krynicki & Checkbox Contributors

## COPYRIGHT

2012-2014 Canonical Ltd