OpenStack Hypervisor

Platform:

Ubuntu
26.04 24.04 22.04
Channel Revision Published Runs on
2026.2/edge 511 11 Nov 2026
Ubuntu 26.04
2026.2/edge 510 11 Nov 2026
Ubuntu 26.04
2026.2/edge 509 11 Nov 2026
Ubuntu 26.04
2026.1/beta 492 14 Oct 2026
Ubuntu 24.04
2026.1/edge 494 13 Oct 2026
Ubuntu 24.04
2026.1/edge 493 13 Oct 2026
Ubuntu 24.04
2026.1/edge 492 13 Oct 2026
Ubuntu 24.04
2025.1/candidate 505 08 Nov 2026
Ubuntu 24.04
2025.1/beta 505 30 Oct 2026
Ubuntu 24.04
2025.1/edge 506 28 Oct 2026
Ubuntu 24.04
2025.1/edge 505 28 Oct 2026
Ubuntu 24.04
2024.1/stable 507 08 Nov 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/stable 216 30 Apr 2025
Ubuntu 24.04 Ubuntu 22.04
2024.1/candidate 507 08 Nov 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/candidate 437 03 Jul 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/candidate 216 16 Jan 2025
Ubuntu 24.04 Ubuntu 22.04
2024.1/beta 507 29 Oct 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/beta 445 15 Jul 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/beta 216 03 Dec 2024
Ubuntu 24.04 Ubuntu 22.04
2024.1/edge 508 28 Oct 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/edge 507 28 Oct 2026
Ubuntu 24.04 Ubuntu 22.04
2024.1/edge 216 29 Nov 2024
Ubuntu 24.04 Ubuntu 22.04
2023.2/stable 144 06 Dec 2023
Ubuntu 22.04
2023.2/candidate 165 25 Mar 2024
Ubuntu 22.04
2023.2/beta 165 25 Mar 2024
Ubuntu 22.04
2023.2/edge 165 23 Feb 2024
Ubuntu 22.04
2023.2/edge 153 24 Nov 2023
Ubuntu 22.04
2023.2/edge 152 24 Nov 2023
Ubuntu 22.04
2023.2/edge 151 24 Nov 2023
Ubuntu 22.04
2023.2/edge 150 24 Nov 2023
Ubuntu 22.04
2023.1/stable 105 26 Sep 2023
Ubuntu 22.04
2023.1/candidate 155 12 Jan 2024
Ubuntu 22.04
2023.1/beta 155 10 Jan 2024
Ubuntu 22.04
2023.1/edge 155 12 Dec 2023
Ubuntu 22.04
2023.1/edge 120 10 Oct 2023
Ubuntu 22.04
2023.1/edge 116 10 Oct 2023
Ubuntu 22.04
2023.1/edge 115 10 Oct 2023
Ubuntu 22.04
2023.1/edge 114 10 Oct 2023
Ubuntu 22.04
juju deploy openstack-hypervisor --channel 2024.1/stable

Learn about actions >

  • disable

    Prevent new instances from being created.

    Params
    • reason string

      Reason for disabling the hypervisor

  • enable

    Allow new instances to be created.

  • list-flavors

    List the flavors or compute host capabilities.

  • list-gpus

    List host GPUs

  • list-nics

    List host NICS, and which one are candidates for use as external NIC.

  • refresh-snap

    Refresh the openstack-hypervisor snap to the latest available revision on the configured channel. The snap is held after installation to prevent automatic refreshes; use this action to apply updates explicitly. Overrides the snap-channel config for this refresh if specified.

    Params
    • channel string

      Channel override for this refresh; defaults to snap-channel.

  • rpc-cache-refresh

    SIGHUP nova-compute to clear the cached RPC version cap. After a SLURP upgrade, nova-compute holds a stale cap pinned to the previous release. This action triggers nova's reset() to re-query the services table and pick up the new minimum version. Zero-downtime. Run this action on every unit (every compute host): each unit's nova-compute holds its own cached cap, so running it on the leader alone is not sufficient.

  • running-guests

    List the running guests on the hypervisor.

    Only lists guests created by the OpenStack cloud.

  • set-hypervisor-local-settings

    Apply settings specific to this hypervisor unit

    Params
    • bridge-mapping string

      Space separated list of bridge:physnet:iface mappings. (br-ex:physnet1:ens3 ...)

    • external-nic string

      NIC that hypervisor will configure for North/South traffic

    • ip-address string

      IP address to use for service configuration

    • ovs-dpdk-ports string

      Comma separated list of interface names that will be used with DPDK.

      The interfaces will be bound to the DPDK-compatible driver (vfio-pci by default) and corresponding DPDK ports will be created in OVS. Any bridges and bonds that use those interfaces will be updated with the resulting DPDK ports, based on the MAAS/Netplan configuration.

      The NUMA nodes of those interfaces will be used to determine pinned CPUs and huge pages used by OVS.

    • pci-excluded-devices string

      A list of PCI addresses that will be excluded from the Nova PCI device whitelist. The main purpose of this setting is to accommodate per-node exclusion lists.

      For example, let's say that the user whitelisted all Intel x550 devices and then excluded one out of 4 such interfaces: pci_device_specs = [{"vendor_id": "8086", "product_id": "1563"}] excluded_devices = ["0000:1b:00.1"]

      The updated device spec will contain the vendor/product and pci address of the remaining 3 Intel x550 devies.

      [
          {"vendor_id": "8086", "product_id": "1563", "address": "0000:19:00.0"},
          {"vendor_id": "8086", "product_id": "1563", "address": "0000:19:00.1"},
          {"vendor_id": "8086", "product_id": "1563", "address": "0000:1b:00.0"},
      ]

      A device spec that doesn't contain any excluded devices will not be modified.

    • spice-proxy-address string

      IP address to use for configuration of SPICE consoles in instances.