• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Waypoint
  • Install
  • Tutorials
  • Documentation
  • CLI
  • Plugins
  • Try Cloud(opens in new tab)
  • Sign up
Waypoint Home

Documentation

Skip to main contentOverview
  • Getting Started


    • Overview
    • app
    • build
    • config
    • deploy
    • hook
    • plugin
    • registry
    • release
    • runner
    • url
    • use
    • variable
  • URL Service
  • Logs
  • Exec
  • Workspaces
  • Plugins
  • Triggers

  • Troubleshooting
  • Glossary

  • Roadmap

  • Resources

  • Tutorial Library
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Waypoint
  3. Documentation
  4. waypoint.hcl
  5. plugin
  • Waypoint
  • v0.9.x
  • v0.8.x
  • v0.7.x
  • v0.6.x
  • v0.5.x
  • v0.4.x
  • v0.3.x
  • v0.2.x
  • v0.1.x

ยปplugin Stanza

Placementplugin

The plugin stanza configures a plugin that will be used by the Waypoint configuration. This can set settings such as the checksum of the plugin, the kind of features the plugin supports, etc.

The plugin stanza is optional. When you use a use stanza, it implicitly defines a plugin that Waypoint will require. You do not need to explicitly create a plugin configuration as well. You only need to create a plugin stanza for additional plugin configuration.

Multiple plugin stanzas can be specified.

plugin "my-platform" {
  checksum = "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"

  type {
    mapper   = true
    platform = true
  }
}

# ...

plugin Parameters

Label

The plugin stanza takes a label. The label of the stanza is the name of the plugin. In the above example, the label is "my-platform"

The plugin name is significant because it defines how the plugin binary will be named on the local system. See plugin loading for more information.

Optional

  • checksum (string: "") - A SHA-256 checksum for the external plugin binary. This has no effect for built-in plugins.

  • type (type: nil) - The type of plugin that this is. A plugin can implement multiple types.

type Parameters

The type stanza is used only within a plugin stanza. It defines what features a plugin implements. Each field in the type stanza should be set to "true" if the plugin implements that type.

Optional

  • builder (bool: false)

  • mapper (bool: false)

  • platform (bool: false)

  • registry (bool: false)

  • releaser (bool: false)

Note: mappers are special. A mapper type plugin is always loaded, because it may provide mapping functions used for other plugins to interoperate.

Edit this page on GitHub

On this page

  1. plugin Stanza
  2. plugin Parameters
  3. type Parameters
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)