You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
reyk ba34eb76dd Add cloud-agent(8) as markdown file 4 years ago
agent Remove /var/db/cloud-instance file on -u 4 years ago
cms Add #if defined(LIBRESSL_VERSION_NUMBER) 4 years ago
extras Initial commit 6 years ago Add README and LICENSE 6 years ago
Makefile Initial commit 6 years ago Add cloud-agent(8) as markdown file 4 years ago Add cloud-agent(8) as markdown file 4 years ago

cloud-agent for OpenBSD

This is a simple OpenBSD-specific agent that aims to handle provisioning and cloud initialization on public clouds such as Microsoft Azure and Amazon AWS. For OpenBSD on Azure, it is a minimal alternative to the WALinuxAgent.


  • OpenBSD 6.1 or higher, nothing else.


  • /usr/local/libexec/cloud-agent
  • /usr/local/bin/cms

The CMS binary is a port of OpenSSL's CMS tool to LibreSSL. LibreSSL has removed CMS which is required by Azure.


See the cloud-agent(8) documentation for more information about the usage.

Basic installation is easy, cloud-agent detects the cloud type automatically.

  • On Microsoft Azure, create a file /etc/hostname.hvn0

  • On Amazon AWS, create a file /etc/hostname.xnf0

  • On Exoscale, create a file /etc/hostname.vio0

  • On OpenBSD VMM (with meta-data), create a file /etc/hostname.vio0

  • On OpenStack/VMware, create a file /etc/hostname.vmx0

  • On OpenNebula, create a file /etc/hostname.if where if is the name of your primary interface.

  • The content of the file is identical for all of them:

      !/usr/local/libexec/cloud-agent "\$if"


Reyk Floeter.

See the License file for more information.