> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/ask/flat/chapter-34-virtualization-and-container-management/di-34.2-jie-shi-yong-bvcp-tong-guo-web-jie-mian-guan-li-bhyve-xu-ni-ji.md). # 34.2 Managing bhyve VMs via Web Interface with BVCP bhyve is the native hypervisor for FreeBSD, providing hardware-assisted virtualization support through the vmm kernel module, allowing guest operating systems to directly utilize CPU virtualization extension instruction sets. BVCP (bhyve Virtual-Machine Control Panel) is a web-based graphical management tool for bhyve that can create, start, and stop virtual machines. This section's test environment is based on FreeBSD 14.2-RELEASE. BVCP version 2.1.4 does not yet support Chinese localization. The software project repository address is: > **Tip** > > No need to configure any services, load any modules, or install other software in advance. Following the steps in this section will complete the operation. ## Installing BVCP Installing BVCP involves the following steps: * **Download the BVCP distribution file**: Use the `fetch` command to obtain the BVCP archive from the official server. ```sh # fetch https://bhyve.npulse.net/release.tgz ``` * **Extract the BVCP distribution file**: Extract the downloaded archive to the current directory. ```sh # tar -xzvf release.tgz ``` * **Install BVCP**: Enter the extracted directory and execute the installation script, which will automatically complete software deployment, database initialization, and service configuration. ```sh # cd bhyve-webadmin root@ykla:/home/ykla/bhyve-webadmin # ./install.sh Installing BVCP into your FreeBSD Installation within seconds ... Press [CTRL] + [C] to Abort ! bvcp_enable: -> YES N 2024-12-21 11:32:35 | Kinga-Framework | 2024/02-17@build-336/FreeBSD64-L N 2024-12-21 11:32:35 | Product Name| BVCP-Backend N 2024-12-21 11:32:35 | Description | BVCP Bhyve Backend/Helper Module N 2024-12-21 11:32:35 | License | Community Edition N 2024-12-21 11:32:35 | Copyright | All rights reserved for the author: nPulse.net / Viktor Hlavaji N 2024-12-21 11:32:35 | Guardian | Create Process, PID: 1132 N 2024-12-21 11:32:35 | SW | VFS:BuiltIn Loaded N 2024-12-21 11:32:35 | ThreadPool | 10/10 Threads initialised N 2024-12-21 11:32:35 | LVM::MAIN | Initialising .. ██████╗ ██╗ ██╗ ██████╗██████╗ ██╔══██╗██║ ██║██╔════╝██╔══██╗ ██████╔╝██║ ██║██║ ██████╔╝ ██╔══██╗╚██╗ ██╔╝██║ ██╔═══╝ ██████╔╝ ╚████╔╝ ╚██████╗██║ ╚═════╝ ╚═══╝ ╚═════╝╚═╝ N 2024-12-21 11:32:35 | BVCP | Initialising BVCP-Backend 2.1.4 Application [>] Generating Entropy ... [217157D53CDD4122589AEE05D866C84C] Welcome to initial setup menu! The Software is located at: /var/lib/nPulse/BVCP The Software is producing pseudo filesystem scheme for virtual machines using symlinks Where to create metadata, iso_images, database, config, logs: (Does not need much space), default: [/vms]_> # Press Enter to confirm; the iso_images required for installation will be stored in this directory ...part omitted... Bhyve Virtual-Machine Control Panel under FreeBSD N 2024-12-21 11:33:46 | BVCP | Initialising BVCP-Backend 2.1.4 Application N 2024-12-21 11:33:48 | BVCP | Starting Database ... (!) Admin Credentials recreated, - User: admin # Username admin - Password: AdJFjNjG # Password AdJFjNjG N 2024-12-21 11:33:48 | SW | Program exited gracefully... Installation Finished! Navigate: https://[your-ip]:8086 # Access address is https://[your-ip]:8086; if accessing from the machine where BVCP is installed, you can use https://localhost:8086 ``` > **Warning** > > The above administrator password is displayed in plaintext on standard output. **Please log in to the web interface and change the default password immediately after installation** to prevent unauthorized access. If the installation process takes place in a non-secure environment (such as a remote SSH session, shared terminal, etc.), ensure that the output has not been intercepted by others. > **Tip** > > The username `ykla`, hostname `ykla`, and path **/home/ykla** shown in the examples in this section are all samples; please replace them with actual values based on your environment. File structure: ```sh / ├── var/ │ └── lib/ │ └── nPulse/ │ └── BVCP/ # BVCP software installation location └── vms/ # Virtual machine metadata, ISO images, database, configuration, and logs storage directory └── iso_images/ # ISO image storage directory ``` ## Installing Ubuntu 24.04 The installation process is divided into two main steps: obtaining the installation image and configuring the virtual machine through the web interface. * **Download the Ubuntu 24.04 installation image**: Obtain the Ubuntu 24.04 desktop edition installation image from the University of Science and Technology of China mirror site. ```sh # fetch https://mirrors.ustc.edu.cn/ubuntu-releases/noble/ubuntu-24.04.1-desktop-amd64.iso ``` * **Move the image to the BVCP image directory**: Move the downloaded ISO file to the BVCP-configured image storage directory so that the web interface can recognize and use it. ```sh # mv ubuntu-24.04.1-desktop-amd64.iso /vms/iso_images ``` After completing the above preparations, you can start creating the virtual machine through the web interface. The following screenshots demonstrate the complete configuration process: ![Configuration process](/files/lEs9b2G9yJNfkK61brnq) ![Configuration process](/files/Uu3YHMcaLSuMjoWulGiS) ![Configuration process](/files/uTSMyGRa4gMSp3IvInoh) When logging in, ignore the email field displayed at the top; simply enter the username `admin` and the corresponding password generated during installation. ![Login interface](/files/C97zbhAYmb92dPRJsb8s) ![Configuration interface](/files/16yjG50yeFYaO1r0YgP1) ![Configuration interface](/files/xnnEAQqvsD9W5SDkjb7U) ![Configuration interface](/files/a99ZCMYlVdTSe5mmW92x) ![Configuration interface](/files/skF3AfruuEvRDQYNhgtQ) ![Configuration interface](/files/5N9cNG9iIUFkcOmWvleb) ![Configuration interface](/files/bicru1StyDFXWHeMpqYO) ![Configuration interface](/files/d7daMSfAIE7GATcSbzfZ) ![Configuration interface](/files/VDH7uefa1huTcCoZYnY8) ![Configuration interface](/files/gypgYOdYvqfVb2IsIDgj) ![Configuration interface](/files/FLMJHLcfv1Sy1BxCFARG) ![Configuration interface](/files/GJomSDHy8oYaRsh8Cvr2) ![Configuration interface](/files/roEPGOrQ5Izq3bqKP4bc) ![Configuration interface](/files/JorrJlU8jELZkQU8TLXV) ![Configuration interface](/files/IDpRAvjHit0MEgNA0bQQ) ![Configuration interface](/files/ywLmdfmkecWm1gYfMBAe) ![Configuration interface](/files/mRce0QlG7Og4MoJZLdJY) ![Configuration interface](/files/lp3kgRX1nDw8DsSyjWte) ![Configuration interface](/files/hzGFTik2pZWvRTwI5Aa1) ![Configuration interface](/files/t0M0epLB0dBZLlZRZDXh) ![Configuration interface](/files/KcbEHCTtUP4YhfWwuugR) ![Configuration interface](/files/wGoSFRpieb423cSf6Tkj) ![Configuration interface](/files/JpIfBrJFv2nTsjtNK9xI) ![Configuration interface](/files/0lvkphgHnRBQNMryUXfY) After installation is complete, press Enter to reboot the system. ![Reboot system](/files/rP4iwK4z2nkBf5xobmpe) After rebooting, enter the new system: ![New system interface](/files/AzsdPxdpX3ltHFBpJalI) ## Installing Windows 11 IoT Enterprise LTSC, version 24H2 (x64) - DVD (English) The detailed steps are similar to the Ubuntu 24.04 installation instructions above; see the previous section "Installing Windows 11 Using bhyve and vm-bhyve" for details. Only the key differences are listed here. When creating a new network interface in the `Create new network interface` step, pay special attention to the network card type selection: ![Network card configuration](/files/Fg5pbWaHjJ48gPLKdwYU) Windows does not include drivers for other network card types by default, so please select the `Intel PRO e1000` network card type. ![Network card selection](/files/DksaPzGb8BzsCQhw1w6e) After completing the network card configuration, you can begin the installation. ![Installation process](/files/oKfeM9ZNGpyyOOCYPXXw) ## Troubleshooting and Unresolved Issues This section lists issues that may be encountered when using BVCP and their solutions. ### How to Uninstall BVCP If you need to uninstall BVCP, refer to the official documentation (FreeBSD bhyve Project. Uninstallation of BVCP\[EB/OL]. \[2026-03-26]. ). ## References * たかちゃん. bhyve を GUI で 操作 する BVCP の 導入。\[EB/OL]. running-dog.net, (2024-02-05)\[2026-03-25]. . Provides a practical guide for BVCP installation and configuration. * FreeBSD bhyve Project. How to install BVCP\[EB/OL]. \[2026-03-25]. . Official installation instructions detailing the BVCP deployment process. * FreeBSD bhyve Project. TroubleShoot / Frequently Asked Questions (FAQ)\[EB/OL]. \[2026-03-25]. . Common troubleshooting and FAQ, providing troubleshooting solutions. * FreeBSD bhyve Project. Deploy Virtual Machine (Windows)\[EB/OL]. \[2026-03-25]. . Official Windows installation instructions detailing Windows virtual machine deployment. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://book.bsdcn.org/ask/flat/chapter-34-virtualization-and-container-management/di-34.2-jie-shi-yong-bvcp-tong-guo-web-jie-mian-guan-li-bhyve-xu-ni-ji.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.