Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

phoenixnap Bare Metal Cloud
Chef Knife Plugin for Bare Metal Cloud

Chef Knife plugin for provisioning and managing Bare Metal Cloud resources.

Bare Metal CloudDevelopers PortalKnowledge BaseSupport


Creating a Bare Metal Cloud account

  1. Go to the Bare Metal Cloud signup page.
  2. Follow the prompts to set up your account.
  3. Use your credentials to log in to Bare Metal Cloud portal.

▶️ Video tutorial: How to Create a Bare Metal Cloud Account

▶️ Video tutorial: Introduction to Bare Metal Cloud

Installing the plugin

The plugin is available as a Ruby gem and you can install it with:

gem install knife-bmc


You need to create a configuration file called config.yaml and save it in the user home directory. This file is used to authenticate access to your Bare Metal Cloud resources.

In your home directory, create a directory .pnap and a config.yaml file inside it. The file needs to contain only two lines of code:

clientId: <enter your client id>
clientSecret: <enter your client secret>

To get the values for the clientId and clientSecret, follow these steps:

  1. Log in to the Bare Metal Cloud portal.
  2. On the left side menu, click on API Credentials.
  3. Click the Create Credentials button.
  4. Fill in the Name and Description fields, select the permissions scope and click Create.
  5. In the table, click on Actions and select View Credentials from the dropdown.
  6. Copy the values from the Client ID and Client Secret fields into your config.yaml file.

Running the plugin with Knife

If the gem has been installed on your system, it should already be available as a knife subcommand:

knife bmc server create (OPTIONS) HOSTNAME
knife bmc server delete (OPTIONS) SERVER_LIST
knife bmc server get (OPTIONS) SERVER_LIST
knife bmc server list (OPTIONS)
knife bmc server poweroff (OPTIONS) SERVER_LIST
knife bmc server poweron (OPTIONS) SERVER_LIST
knife bmc server reboot (OPTIONS) SERVER_LIST
knife bmc server reset (OPTIONS) SERVER_ID_LIST
knife bmc server shutdown (OPTIONS) SERVER_LIST
knife bmc sshkey create (OPTIONS) KEYFILE
knife bmc sshkey delete (OPTIONS)
knife bmc sshkey list

Bare Metal Cloud community

Become part of the Bare Metal Cloud community to get updates on new features, help us improve the platform, and engage with developers and other users.



Contact phoenixNAP

Get in touch with us if you have questions or need help with Bare Metal Cloud.


phoenixnap Bare Metal Cloud


Chef Knife plugin for provisioning and managing Bare Metal Cloud resources







No releases published


No packages published