Spin Command Line Interface (CLI) Reference
- spin add
- spin build
- spin cloud
- spin cloud apps
- spin cloud deploy
- spin cloud link
- spin cloud login
- spin cloud sqlite
- spin cloud unlink
- spin cloud variables
- spin deploy
- spin doctor
- spin help
- spin kube
- spin kube completion
- spin kube scaffold
- spin login
- spin new
- spin plugins
- spin plugins install
- spin plugins list
- spin plugins search
- spin plugins uninstall
- spin plugins update
- spin plugins upgrade
- spin registry
- spin registry login
- spin registry pull
- spin registry push
- spin templates
- spin templates install
- spin templates list
- spin templates uninstall
- spin templates upgrade
- spin test
- spin up
- spin watch
- Stability Table
This page documents the Spin Command Line Interface (CLI).
Please note: When using the
spin --help
command you may see additional commands (followed by an asterisk symbol). These additional commands that are visible on your machine will show up depending on what plugins you have installed locally.
For information on command stability, see the CLI stability table.
spin add
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
--no-vcs An optional argument that allows to skip creating .gitignore
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin add --help
spin-add
Scaffold a new component into an existing application
USAGE:
spin add [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-f, --file <APP_MANIFEST_FILE> Path to spin.toml
-h, --help Print help information
--init Create the new application or component in the current
directory
--no-vcs An optional argument that allows to skip creating .gitignore
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
spin build
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
$ spin build --help
spin-build
Build the Spin application
USAGE:
spin build [OPTIONS] [--] [UP_ARGS]...
ARGS:
<UP_ARGS>...
OPTIONS:
-c, --component-id <COMPONENT_ID>...
Component ID to build. This can be specified multiple times. The default is all
components
-f, --from <APP_MANIFEST_FILE>
The application to build. This may be a manifest (spin.toml) file, or a directory
containing a spin.toml file. If omitted, it defaults to "spin.toml" [default: spin.toml]
-h, --help
Print help information
-u, --up
Run the application after building
spin cloud
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
The spin cloud
command is implemented by the Fermyon Cloud Plugin.
spin cloud apps
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
The spin cloud apps
command is implemented by the Fermyon Cloud Plugin.
spin cloud deploy
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
The spin cloud deploy
command is implemented by the Fermyon Cloud Plugin.
spin cloud link
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
The spin cloud link
command is implemented by the Fermyon Cloud Plugin.
spin cloud login
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
The spin cloud login
command is implemented by the Fermyon Cloud Plugin.
spin cloud sqlite
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
The spin cloud sqlite
command is implemented by the Fermyon Cloud Plugin.
spin cloud unlink
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
The spin cloud unlink
command is implemented by the Fermyon Cloud Plugin.
spin cloud variables
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
The spin cloud variables
command is implemented by the Fermyon Cloud Plugin.
spin deploy
spin deploy
is a shortcut to spin cloud deploy.
spin doctor
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
$ spin doctor --help
spin-doctor
Detect and fix problems with Spin applications
USAGE:
spin doctor [OPTIONS]
OPTIONS:
-f, --from <APP_MANIFEST_FILE> The application to check. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
spin help
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
Please note: Spin
help
is a convenient way to access help using a subcommand, instead of using the--help
option. For example,spin help cloud
will give you the same output asspin cloud --help
. Similarly,spin help build
will give you the same output asspin build --help
and so forth.
spin kube
The spin kube
command is implemented by the spin-kube
plugin.
The spin kube
command is implemented by the spin-kube
plugin.
spin kube completion
The spin kube completion
command is implemented by the spin-kube
plugin.
The spin kube completion
command is implemented by the spin-kube
plugin.
spin kube scaffold
The spin kube scaffold
command is implemented by the spin-kube
plugin.
The spin kube scaffold
command is implemented by the spin-kube
plugin.
spin login
spin login
is a shortcut to spin cloud login
.
spin new
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
--no-vcs An optional argument that allows to skip creating .gitignore
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
--no-vcs An optional argument that allows to skip creating .gitignore
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
$ spin new --help
spin-new
Scaffold a new application based on a template
USAGE:
spin new [OPTIONS] [NAME]
ARGS:
<NAME> The name of the new application or component
OPTIONS:
-a, --accept-defaults An optional argument that allows to skip prompts for the
manifest file by accepting the defaults if available on the
template
-h, --help Print help information
--init Create the new application or component in the current
directory
--no-vcs An optional argument that allows to skip creating .gitignore
-o, --output <OUTPUT_PATH> The directory in which to create the new application or
component. The default is the name argument
-t, --template <TEMPLATE_ID> The template from which to create the new application or
component. Run `spin templates list` to see available options
--tag <TAGS> Filter templates to select by tags
-v, --value <VALUES> Parameter values to be passed to the template (in name=value
format)
--values-file <VALUES_FILE> A TOML file which contains parameter values in name = "value"
format. Parameters passed as CLI option overwrite parameters
specified in the file
Please note: spin new
vs spin add
. These commands are similar except that:
spin new
creates a new application - that is, a new directory with a newspin.toml
file.spin add
adds a component to an existing application - that is, it modifies an existingspin.toml
file.
spin plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
$ spin plugins --help
spin-plugins
Install/uninstall Spin plugins
USAGE:
spin plugins <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install plugin from a manifest
list List available or installed plugins
search Search for plugins by name
uninstall Remove a plugin from your installation
update Fetch the latest Spin plugins from the spin-plugins repository
upgrade Upgrade one or all plugins
spin plugins install
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
$ spin plugins install --help
spin-plugins-install
Install plugin from a manifest.
The binary file and manifest of the plugin is copied to the local Spin plugins directory.
USAGE:
spin plugins install [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME>
Name of Spin plugin
OPTIONS:
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
URL of remote plugin manifest to install
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin
spin plugins list
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
$ spin plugins list --help
spin-plugins-list
List available or installed plugins
USAGE:
spin plugins list [OPTIONS]
OPTIONS:
--filter <FILTER> Filter the list to plugins containing this string
-h, --help Print help information
--installed List only installed plugins
spin plugins search
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
$ spin plugins search --help
spin-plugins-search
Search for plugins by name
USAGE:
spin plugins search [FILTER]
ARGS:
<FILTER> The text to search for. If omitted, all plugins are returned
OPTIONS:
-h, --help Print help information
spin plugins uninstall
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
$ spin plugins uninstall --help
spin-plugins-uninstall
Remove a plugin from your installation
USAGE:
spin plugins uninstall <NAME>
ARGS:
<NAME> Name of Spin plugin
OPTIONS:
-h, --help Print help information
spin plugins update
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
$ spin plugins update --help
spin-plugins-update
Fetch the latest Spin plugins from the spin-plugins repository
USAGE:
spin plugins update
OPTIONS:
-h, --help Print help information
spin plugins upgrade
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
$ spin plugins upgrade --help
spin-plugins-upgrade
Upgrade one or all plugins
USAGE:
spin plugins upgrade [OPTIONS] [PLUGIN_NAME]
ARGS:
<PLUGIN_NAME> Name of Spin plugin to upgrade
OPTIONS:
-a, --all
Upgrade all plugins
-d, --downgrade
Allow downgrading a plugin's version
-f, --file <LOCAL_PLUGIN_MANIFEST>
Path to local plugin manifest
-h, --help
Print help information
--override-compatibility-check
Overrides a failed compatibility check of the plugin with the current version of Spin
-u, --url <REMOTE_PLUGIN_MANIFEST>
Path to remote plugin manifest
-v, --version <VERSION>
Specific version of a plugin to be install from the centralized plugins repository
-y, --yes
Skips prompt to accept the installation of the plugin[s]
Note: For additional information, please see the Managing Plugins and/or Creating Plugins sections of the documentation.
spin registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
$ spin registry --help
spin-registry
Commands for working with OCI registries to distribute applications
USAGE:
spin registry <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
login Log in to a registry
pull Pull a Spin application from a registry
push Push a Spin application to a registry
spin registry login
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER>
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER> OCI registry server (e.g. ghcr.io)
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER> OCI registry server (e.g. ghcr.io)
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER> OCI registry server (e.g. ghcr.io)
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER> OCI registry server (e.g. ghcr.io)
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
$ spin registry login --help
spin-registry-login
Log in to a registry
USAGE:
spin registry login [OPTIONS] <SERVER>
ARGS:
<SERVER> OCI registry server (e.g. ghcr.io)
OPTIONS:
-h, --help Print help information
-p, --password <PASSWORD> Password for the registry
--password-stdin Take the password from stdin
-u, --username <USERNAME> Username for the registry
spin registry pull
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference of the Spin application
OPTIONS:
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the published Spin application. This is a string
whose format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the published Spin application. This is a string
whose format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the published Spin application. This is a string
whose format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the published Spin application. This is a string
whose format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--cache-dir <CACHE_DIR> Cache directory for downloaded registry data
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry pull --help
spin-registry-pull
Pull a Spin application from a registry
USAGE:
spin registry pull [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the published Spin application. This is a string
whose format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--cache-dir <CACHE_DIR> Cache directory for downloaded registry data
-h, --help Print help information
-k, --insecure Ignore server certificate errors
spin registry push
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference of the Spin application
OPTIONS:
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the Spin application. This is a string whose
format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the Spin application. This is a string whose
format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the Spin application. This is a string whose
format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the Spin application. This is a string whose
format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--annotation <ANNOTATIONS> Specifies the OCI image manifest annotations (in key=value
format). Any existing value will be overwritten. Can be used
multiple times
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
--cache-dir <CACHE_DIR> Cache directory for downloaded registry data
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
$ spin registry push --help
spin-registry-push
Push a Spin application to a registry
USAGE:
spin registry push [OPTIONS] <REFERENCE>
ARGS:
<REFERENCE> Reference in the registry of the Spin application. This is a string whose
format is defined by the registry standard, and generally consists of
<registry>/<username>/<application-name>:<version>. E.g.
ghcr.io/ogghead/spin-test-app:0.1.0
OPTIONS:
--annotation <ANNOTATIONS> Specifies the OCI image manifest annotations (in key=value
format). Any existing value will be overwritten. Can be used
multiple times
--build Specifies to perform `spin build` before pushing the
application [env: SPIN_ALWAYS_BUILD=]
--cache-dir <CACHE_DIR> Cache directory for downloaded registry data
-f, --from <APP_MANIFEST_FILE> The application to push. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
-k, --insecure Ignore server certificate errors
spin templates
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
$ spin templates --help
spin-templates
Commands for working with WebAssembly component templates
USAGE:
spin templates <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
install Install templates from a Git repository or local directory
list List the installed templates
uninstall Remove a template from your installation
upgrade Upgrade templates to match your current version of Spin
spin templates install
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
$ spin templates install --help
spin-templates-install
Install templates from a Git repository or local directory.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates install [OPTIONS]
OPTIONS:
--branch <BRANCH>
The optional branch of the git repository
--dir <FROM_DIR>
Local directory containing the template(s) to install
--git <FROM_GIT>
The URL of the templates git repository. The templates must be in a git repository in a
"templates" directory
-h, --help
Print help information
--upgrade
If present, updates existing templates instead of skipping
spin templates list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
$ spin templates list --help
spin-templates-list
List the installed templates
USAGE:
spin templates list [OPTIONS]
OPTIONS:
-h, --help Print help information
--tag <TAGS> Filter templates matching all provided tags
--verbose Whether to show additional template details in the list
spin templates uninstall
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
$ spin templates uninstall --help
spin-templates-uninstall
Remove a template from your installation
USAGE:
spin templates uninstall <TEMPLATE_ID>
ARGS:
<TEMPLATE_ID> The template to uninstall
OPTIONS:
-h, --help Print help information
spin templates upgrade
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
$ spin templates upgrade --help
spin-templates-upgrade
Upgrade templates to match your current version of Spin.
The files of the templates are copied to the local template store: a directory in your data or home
directory.
USAGE:
spin templates upgrade [OPTIONS]
OPTIONS:
--all
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade all repositories without prompting
--branch <BRANCH>
The optional branch of the git repository, if a specific repository is given
-h, --help
Print help information
--repo <GIT_URL>
By default, Spin displays the list of installed repositories and prompts you to choose
which to upgrade. Pass this flag to upgrade only the specified repository without
prompting
Note: For additional information, please see the Managing Templates and/or Creating Templates sections of the documentation.
spin test
$ spin test --help
By default `spin-test` will invoke the `run` subcommand.
Usage: test [COMMAND]
Commands:
run Run a test suite against a Spin application
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
Note: For additional information, please see the Managing Templates and/or Creating Templates sections of the documentation.
$ spin test --help
By default `spin-test` will invoke the `run` subcommand.
Usage: test [COMMAND]
Commands:
run Run a test suite against a Spin application
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
spin up
The following options are available in relation to running your Spin application.
Note: There are three trigger options which only applies to the HTTP trigger (--listen
, --tls-cert
and --tls-key
).
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running the
application [env: SPIN_ALWAYS_BUILD=]
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file, a
directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Enable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running the
application [env: SPIN_ALWAYS_BUILD=]
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file, a
directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Enable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running the
application [env: SPIN_ALWAYS_BUILD=]
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file, a
directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
HTTP TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Disable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components. Setting to the empty string
disables logging to disk
[env: SPIN_LOG_DIR=]
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running the
application [env: SPIN_ALWAYS_BUILD=]
--cache-dir <CACHE_DIR> Cache directory for downloaded components and assets
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file, a
directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
HTTP TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Disable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components. Setting to the empty string
disables logging to disk
[env: SPIN_LOG_DIR=]
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running
the application [env: SPIN_ALWAYS_BUILD=]
--cache-dir <CACHE_DIR> Cache directory for downloaded components and assets
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file,
a directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
HTTP TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Disable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components. Setting to the empty string
disables logging to disk
[env: SPIN_LOG_DIR=]
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
$ spin up --help
spin-up
Start the Spin application
USAGE:
spin up [OPTIONS]
OPTIONS:
--build For local apps, specifies to perform `spin build` before running
the application [env: SPIN_ALWAYS_BUILD=]
--cache-dir <CACHE_DIR> Cache directory for downloaded components and assets
--direct-mounts For local apps with directory mounts and no excluded files, mount
them directly instead of using a temporary directory
-e, --env <ENV> Pass an environment variable (key=value) to all components of the
application
-f, --from <APPLICATION> The application to run. This may be a manifest (spin.toml) file,
a directory containing a spin.toml file, or a remote registry
reference. If omitted, it defaults to "spin.toml"
-h, --help
-k, --insecure Ignore server certificate errors from a registry
--temp <TMP> Temporary directory for the static assets of the components
HTTP TRIGGER OPTIONS:
--allow-transient-write
Set the static assets of the components in the temporary directory as writable
--cache <WASMTIME_CACHE_FILE>
Wasmtime cache configuration file
[env: WASMTIME_CACHE_FILE=]
--disable-cache
Disable Wasmtime cache
[env: DISABLE_WASMTIME_CACHE=]
--disable-pooling
Disable Wasmtime's pooling instance allocator
--follow <FOLLOW_ID>
Print output to stdout/stderr only for given component(s)
--key-value <KEY_VALUES>
Set a key/value pair (key=value) in the application's default store. Any existing value
will be overwritten. Can be used multiple times
-L, --log-dir <APP_LOG_DIR>
Log directory for the stdout and stderr of components. Setting to the empty string
disables logging to disk
[env: SPIN_LOG_DIR=]
-q, --quiet
Silence all component output to stdout/stderr
--runtime-config-file <RUNTIME_CONFIG_FILE>
Configuration file for config providers and wasmtime config
[env: RUNTIME_CONFIG_FILE=]
--sqlite <SQLITE_STATEMENTS>
Run a SQLite statement such as a migration against the default database. To run from a
file, prefix the filename with @ e.g. spin up --sqlite @migration.sql
--state-dir <STATE_DIR>
Set the application state directory path. This is used in the default locations for
logs, key value stores, etc.
For local apps, this defaults to `.spin/` relative to the `spin.toml` file. For remote
apps, this has no default (unset). Passing an empty value forces the value to be unset.
Please note: If the
-f
or--from
options do not accurately infer the intended registry or.toml
file for your application, then you can explicitly specify either the--from-registry
or--from-file
options to clarify this.
spin up (HTTP Trigger)
The following additional trigger options are available for the spin up command, when using the HTTP trigger. E.g. spin up --listen
--listen <ADDRESS>
IP address and port to listen on
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
--listen <ADDRESS>
IP address and port to listen on
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
--listen <ADDRESS>
IP address and port to listen on
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
--listen <ADDRESS>
IP address and port to listen on
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
--listen <ADDRESS>
IP address and port to listen on
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
--listen <ADDRESS>
IP address and port to listen on
[env: SPIN_HTTP_LISTEN_ADDR=]
[default: 127.0.0.1:3000]
--tls-cert <TLS_CERT>
The path to the certificate to use for https, if this is not set, normal http will be
used. The cert should be in PEM format
[env: SPIN_TLS_CERT=]
--tls-key <TLS_KEY>
The path to the certificate key to use for https, if this is not set, normal http will
be used. The key should be in PKCS#8 format
[env: SPIN_TLS_KEY=]
spin watch
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
$ spin watch --help
spin-watch
Build and run the Spin application, rebuilding and restarting it when files change
USAGE:
spin watch [OPTIONS] [UP_ARGS]...
ARGS:
<UP_ARGS>... Arguments to be passed through to spin up
OPTIONS:
-c, --clear Clear the screen before each run
-d, --debounce <DEBOUNCE> Set the timeout between detected change and re-execution, in
milliseconds [default: 100]
-f, --from <APP_MANIFEST_FILE> The application to watch. This may be a manifest (spin.toml)
file, or a directory containing a spin.toml file. If omitted,
it defaults to "spin.toml" [default: spin.toml]
-h, --help Print help information
--skip-build Only run the Spin application, restarting it when build
artifacts change
Stability Table
CLI commands have four phases that indicate levels of stability:
Experimental
: These commands are experiments and may or may not be available in later versions of the CLI.Stabilizing
: These commands have moved out of theexperimental
phase and we are now in the active process of stabilizing them. This includes updating flags, command output, errors, and more.Stable
: These commands have moved out of thestablizing
phase and will not change in backwards incompatible ways until the next major version release.Deprecated
: Support for these commands will be removed in a future release.
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
spin test | Experimental |
Command | Stability |
---|---|
spin add | Stable |
spin build | Stable |
spin new | Stable |
spin plugins | Stable |
spin templates | Stable |
spin up | Stable |
spin cloud | Stabilizing |
spin registry | Stabilizing |
spin doctor | Experimental |
spin watch | Experimental |
spin test | Experimental |