Skip to main content

wash app

When deploying apps using wadm, the easiest way to manage these apps is using wash app. wash app provides us with all the tools needed to add, remove and get the necessary details of your deployed as well as undeployed applications. Following are the subcommands available under wash app.

  • list
  • get
  • history
  • delete
  • put
  • deploy
  • undeploy


This will retrieve a list of all applications that wadm knows about. Application specifications (also referred to in our documentation and code as "models") are stored in a model store and are associated to your lattice.


wash app list


The get command is used to retrieve the details for a specific version of a model. You can retrieve both the original text (e.g. YAML) that you submitted and the vetted and normalized model in JSON format.


wash app get <name> [version]
wash app get petclinic 0.0.1
wash app get petclinic 0.0.1 -o json


The history command is used to retrieve the version history of a given model. You can view all the previous versions available in store and their respective status for a given app.


wash app history <name>
wash app history petclinic


The delete command is used to delete an application model of a specific version. You can optionally delete all versions of a specification as well.


wash app delete <name> <version>
wash app delete petclinic 0.0.1
wash app delete petclinic --delete-all


Performs an idempotent put operation for an application specification version. Each time you put a model spec YAML to the server, it will either produce a new version or be ignored. Versions are immutable and as such cannot be overwritten. If you wish to change anything about your spec, it needs to be done in a new version.


wash app put <SOURCE>
wash app put petclinic.yaml


When a version of an application specification is deployed, wadm will start monitoring the state of your lattice. Wadm will compare the desired state of an application with its current state and issue the appropriate commands to reconcile the state.


wash app deploy <name> [version]
wash app deploy petclinic v0.0.1


Undeploying an application spec tells wadm to stop monitoring that deployment. By default, all resources originally provisioned for an application will be removed after that application is undeployed.


wash app undeploy <name>
wash app undeploy petclinic


The following options can be specified with all of the above subcommands for a finer control of your environment.


Alias: -o. Specify output format (text or json). The default value is text.


Alias: -r. CTL Host for connection. The default value is for local nats [env: WASMCLOUD_CTL_HOST=]


Whether or not to enable experimental features [env: WASH_EXPERIMENTAL=]


Alias: -p. CTL Port for connections, defaults to 4222 for local nats [env: WASMCLOUD_CTL_PORT=]


JWT file for CTL authentication. Must be supplied with ctl_seed [env: WASMCLOUD_CTL_JWT]


Seed file or literal for CTL authentication. Must be supplied with ctl_jwt [env: WASMCLOUD_CTL_SEED]


Credsfile for CTL authentication. Combines ctl_seed and ctl_jwt. See for details [env: WASH_CTL_CREDS]


JS domain for wasmCloud control interface. Defaults to None [env: WASMCLOUD_JS_DOMAIN]


Alias: -x. Lattice name for wasmCloud control interface. The default value is "default". [env: WASMCLOUD_LATTICE_PREFIX=]


Alias: -t. Timeout length to await a control interface response. The default value is 2000 milliseconds [env: WASMCLOUD_CTL_TIMEOUT_MS=] [default: 2000]


Path to a context with values to use for CTL connection and authentication