Hyperkit NotFound Error

Resolve Hyperkit NotFound errors caused by missing LXD network bridges.

This error occurs when Vagrant attempts to manage an LXD instance in a project where a required network bridge is missing.

/home/onknows/.vagrant.d/gems/3.1.4/gems/hyperkit-1.3.0/lib/hyperkit/response/raise_error.rb:38:in “https://127.0.0.1:8443/1.0/instances/pxd-rproxy1?project=default:” “`on_complete’: GET” > 404 - Error: Failed to fetch instance “pxd-rproxy1” in project “default”: Instance not found (Hyperkit::NotFound)

Complete log file: hyperkit-notfound.log 

The error commonly appears when one or more required LXD bridges are absent. The following bridges are used by the reference implementations:

  • lxdbr0: default bridge, always present.
  • lxdbr1: used by the C2 reference implementation.
  • lxdbrag1: used by the Rijkswaterstaat (RWS) reference implementation.
  • phx: used by the Phoenix PXD reference implementation.

Run the command below to list all configured LXD networks and verify that the required bridges exist:

lxc network ls

Example output:

+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
|      NAME       |   TYPE   | MANAGED |      IPV4       | IPV6 | DESCRIPTION | USED BY |  STATE  |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| enp0s31f6       | physical | NO      |                 |      |             | 0       |         |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| enxc8a36222fb29 | physical | NO      |                 |      |             | 0       |         |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| lxdbr0          | bridge   | YES     | 10.227.66.1/24  | none |             | 8       | CREATED |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| lxdbr1          | bridge   | YES     | 1.1.4.1/24      | none |             | 6       | CREATED |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| phx             | bridge   | YES     | 192.168.60.1/24 | none |             | 2       | CREATED |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| wlp0s20f3       | physical | NO      |                 |      |             | 0       |         |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+
| wwan0           | physical | NO      |                 |      |             | 0       |         |
+-----------------+----------+---------+-----------------+------+-------------+---------+---------+

Additional Information


Last modified August 3, 2026: howto dev env setup lxd PHX-655 (bba4fef)