Latest Content

How to Publish a Build

Updated on 05 August, 2026

Publish a Vultr Marketplace application build using the Vultr Console or Vultr API to make the new image version available for your customers to deploy.

Marketplace apps can have multiple builds attached for testing purposes, but only one build can be the Live build, which is the version customers deploy. Builds in Not Live status are not visible to the public.

This guide explains how to publish a build using the Vultr Console or the Vultr API.

  • Vultr Console
  • Vultr API

  1. Click Marketplace in the Vultr Console's left-hand menu.

  2. Click the application name to open the Edit App screen.

  3. Click the Builds tab.

  4. Click the Version link on the build. Enter a version number to identify this image. The Status displays Not Live.

  5. Click the Actions icon.

    Choose an action:

    • Publish Image: Set the image to Live status. Verify that the build's Status displays Live.
    • Deploy Image: Test an image deployment before publishing it in Live status. Test your image before making the app public.

    To choose a different Live version, use the Actions icon to unpublish the current Live image first.

  1. Send a POST request to the Publish Marketplace App Build Image endpoint to set a build as the Live version customers deploy. Replace {app-id} and {build-id} with your values.

    console 
    $ curl "https://api.vultr.com/v2/marketplace/apps/{app-id}/builds/{build-id}/publish" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    A successful request returns an HTTP 204 No Content response.

  2. Send a POST request to the Unpublish Marketplace App Build Image endpoint to take the current build out of Live status before publishing a different one.

    console 
    $ curl "https://api.vultr.com/v2/marketplace/apps/{app-id}/builds/{build-id}/unpublish" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    A successful request returns an HTTP 204 No Content response.

Comments