8000 GitHub - myb-project/mybee-qt: MyBee GUI client
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

myb-project/mybee-qt

< 8000 script type="application/json" data-target="react-partial.embeddedData">{"props":{"initialPayload":{"allShortcutsEnabled":false,"path":"/","repo":{"id":823291988,"defaultBranch":"main","name":"mybee-qt","ownerLogin":"myb-project","currentUserCanPush":false,"isFork":false,"isEmpty":false,"createdAt":"2024-07-02T18:48:44.000Z","ownerAvatar":"https://avatars.githubusercontent.com/u/103197781?v=4","public":true,"private":false,"isOrgOwned":true},"currentUser":null,"refInfo":{"name":"main","listCacheKey":"v0:1739729327.0","canEdit":false,"refType":"branch","currentOid":"480a325bf9e10d39d8ece492c8de13f4ebf2d584"},"tree":{"items":[{"name":".github","path":".github","contentType":"directory"},{"name":"deploy","path":"deploy","contentType":"directory"},{"name":"docs","path":"docs","contentType":"directory"},{"name":"freerdp2","path":"freerdp2","contentType":"directory"},{"name":"libjpeg-turbo","path":"libjpeg-turbo","contentType":"directory"},{"name":"libssh","path":"libssh","contentType":"directory"},{"name":"src","path":"src","contentType":"directory"},{"name":"vnc","path":"vnc","contentType":"directory"},{"name":"zlib-ng","path":"zlib-ng","contentType":"directory"},{"name":"APP_VERSION","path":"APP_VERSION","contentType":"file"},{"name":"LICENSE","path":"LICENSE","contentType":"file"},{"name":"README.md","path":"README.md","contentType":"file"},{"name":"README.ru.md","path":"README.ru.md","contentType":"file"},{"name":"common.pri","path":"common.pri","contentType":"file"},{"name":"lupdate-ru_RU.sh","path":"lupdate-ru_RU.sh","contentType":"file"},{"name":"lupdate.sh","path":"lupdate.sh","contentType":"file"},{"name":"mybee-qt.pro","path":"mybee-qt.pro","contentType":"file"}],"templateDirectorySuggestionUrl":null,"readme":null,"totalCount":17,"showBranchInfobar":false},"fileTree":null,"fileTreeProcessingTime":null,"foldersToFetch":[],"treeExpanded":false,"symbolsExpanded":false,"isOverview":true,"overview":{"banners":{"shouldRecommendReadme":false,"isPersonalRepo":false,"showUseActionBanner":false,"actionSlug":null,"actionId":null,"showProtectBranchBanner":false,"publishBannersInfo":{"dismissActionNoticePath":"/settings/dismiss-notice/publish_action_from_repo","releasePath":"/myb-project/mybee-qt/releases/new?marketplace=true","showPublishActionBanner":false},"interactionLimitBanner":null,"showInvitationBanner":false,"inviterName":null,"actionsMigrationBannerInfo":{"releaseTags":[],"showImmutableActionsMigrationBanner":false,"initialMigrationStatus":null}},"codeButton":{"contactPath":"/contact","isEnterprise":false,"local":{"protocolInfo":{"httpAvailable":true,"sshAvailable":null,"httpUrl":"https://github.com/myb-project/mybee-qt.git","showCloneWarning":null,"sshUrl":null,"sshCertificatesRequired":null,"sshCertificatesAvailable":null,"ghCliUrl":"gh repo clone myb-project/mybee-qt","defaultProtocol":"http","newSshKeyUrl":"/settings/ssh/new","setProtocolPath":"/users/set_protocol"},"platformInfo":{"cloneUrl":"https://desktop.github.com","showVisualStudioCloneButton":false,"visualStudioCloneUrl":"https://windows.github.com","showXcodeCloneButton":false,"xcodeCloneUrl":"xcode://clone?repo=https%3A%2F%2Fgithub.com%2Fmyb-project%2Fmybee-qt","zipballUrl":"/myb-project/mybee-qt/archive/refs/heads/main.zip"}},"newCodespacePath":"/codespaces/new?hide_repo_select=true\u0026repo=823291988"},"popovers":{"rename":null,"renamedParentRepo":null},"commitCount":"33","overviewFiles":[{"displayName":"README.md","repoName":"mybee-qt","refName":"main","path":"README.md","preferredFileType":"readme","tabName":"README","richText":"\u003carticle class=\"markdown-body entry-content container-lg\" itemprop=\"text\"\u003e\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch1 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eMyBee-QT: cross-platform GUI client for CBSD\u003c/h1\u003e\u003ca id=\"user-content-mybee-qt-cross-platform-gui-client-for-cbsd\" class=\"anchor\" aria-label=\"Permalink: MyBee-QT: cross-platform GUI client for CBSD\" href=\"#mybee-qt-cross-platform-gui-client-for-cbsd\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp align=\"center\" dir=\"auto\"\u003e\n \u003cspan\u003eEnglish\u003c/span\u003e |\n \u003ca href=\"/myb-project/mybee-qt/blob/main/README.es.md\"\u003eEspañol\u003c/a\u003e |\n \u003ca href=\"/myb-project/mybee-qt/blob/main/README.fr.md\"\u003eFrançais\u003c/a\u003e |\n \u003ca href=\"/myb-project/mybee-qt/blob/main/README.de.md\"\u003eDeutsch\u003c/a\u003e |\n \u003ca href=\"/myb-project/mybee-qt/blob/main/README.ru.md\"\u003eРусский\u003c/a\u003e |\n \u003ca href=\"/myb-project/mybee-qt/blob/main/README.ch.md\"\u003e中文\u003c/a\u003e |\n\u003c/p\u003e\n\u003chr\u003e\n\u003cp dir=\"auto\"\u003eℹ️ This guide covers the administration and use of \u003ca href=\"https://github.com/myb-project/mybee-qt\"\u003eMyBee-QT\u003c/a\u003e, a graphical client for \u003ca href=\"https://github.com/cbsd/cbsd\"\u003eCBSD\u003c/a\u003e (and \u003ca href=\"https://myb.convectix.com/\" rel=\"nofollow\"\u003eMyBee OS\u003c/a\u003e).\u003c/p\u003e\n\u003chr\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eWelcome to MyBee-QT\u003c/h2\u003e\u003ca id=\"user-content-welcome-to-mybee-qt\" class=\"anchor\" aria-label=\"Permalink: Welcome to MyBee-QT\" href=\"#welcome-to-mybee-qt\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003e(*) What is \u003cstrong\u003eMyBee-QT\u003c/strong\u003e: it is a cross-platform QT-based application that provides a graphical interface for working with virtual machines and containers (creation, deletion, start and stop) on those platforms where \u003cstrong\u003eCBSD\u003c/strong\u003e can work.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eIt supports three modes:\u003c/p\u003e\n\u003col dir=\"auto\"\u003e\n\u003cli\u003e\n\u003cp dir=\"auto\"\u003elocally (similar to the virsh or VirtualBox mode): you install it on your Desktop computer running Linux or BSD and work locally with virtual environments. In this case, MyBee-QT works directly with the \u003ccode\u003ecbsd\u003c/code\u003e interpreter via \u003ccode\u003eshell\u003c/code\u003e;\u003c/p\u003e\n\u003c/li\u003e\n\u003cli\u003e\n\u003cp dir=\"auto\"\u003eremotely via a simple RestAPI service: you use your Desktop computer (it can be a mobile device, such as a phone) as a thin client and work with a Linux or FreeBSD server on which \u003cstrong\u003eCBSD\u003c/strong\u003e and RestAPI to it are installed.\u003c/p\u003e\n\u003c/li\u003e\n\u003cli\u003e\n\u003cp dir=\"auto\"\u003eremotely via SSH with the \u003ccode\u003ecbsd\u003c/code\u003e interpreter via \u003ccode\u003eshell\u003c/code\u003e (similar to how virt-manager works): the method is close to point 1, but SSH is added as a transport. This method does not require additional installation of the RestAPI service and turns any server running Linux/FreeBSD and OpenSSH into a host for your virtual environments.\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp dir=\"auto\"\u003e\u003ca target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https://camo.githubusercontent.com/0abdf148ab9a2d357ccf6904903322c1b2d47e6345e328186487c59cd501e0db/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d71742d6f76657276696577322e706e673f7261773d74727565\"\u003e\u003cimg src=\"https://camo.githubusercontent.com/0abdf148ab9a2d357ccf6904903322c1b2d47e6345e328186487c59cd501e0db/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d71742d6f76657276696577322e706e673f7261773d74727565\" alt=\"mybee-qt-overview2.png\" data-canonical-src=\"https://myb.convectix.com/img/mybee-qt-overview2.png?raw=true\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eYou are not limited to using any one method - one copy of \u003cstrong\u003eMyBee-QT\u003c/strong\u003e can serve both local environments and RestAPI/OpenSSH-only systems at the same time.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003e(*) What is \u003cstrong\u003eCBSD\u003c/strong\u003e: it is a cross-platform (FreeBSD, Linux, DragonFlyBSD) library (set of scripts) for low-level work with virtual environments (creation, deletion, launch and shutdown) working with hypervisors such as: bhyve, KVM, QEMU, XEN, VirtualBox, as well as lightweight containers based on jail technology.\nBy installing the \u003cstrong\u003eCBSD\u003c/strong\u003e package on any Linux or FreeBSD node, you get the ability to use hypervisors and node resources for virtual machines, creating them in the GUI.\nThe \u003cstrong\u003eMyBee-QT\u003c/strong\u003e application owes its appearance to the \u003cstrong\u003eCBSD\u003c/strong\u003e project and its community, since the development was sponsored by the \u003ca href=\"https://www.patreon.com/clonos\" rel=\"nofollow\"\u003eCBSD donation fund\u003c/a\u003e.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003e(*) What is \u003cstrong\u003eMyBee OS\u003c/strong\u003e: this is an experimental distribution (two variants - based on Linux/Debian and FreeBSD) with pre-installed \u003cstrong\u003eCBSD\u003c/strong\u003e, RestAPI and OpenSSH services, optimized for creating virtual environments.\nIt was created as a PoC, demonstrating that having bare metal without any OS, within 5 minutes you can already start working in virtual machines using server resources (~1-2 minutes takes the firmware of the MyBee hypervisor, then everything depends on the speed of your Internet connection).\nHowever, in addition to the demo nature, the distribution can find applications in trusted environments.\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eWith \u003cstrong\u003eMyBee-QT\u003c/strong\u003e, the user can get a hybrid cloud consisting of various Linux, FreeBSD, DragonFlyBSD (the list will be expanded) systems that run VMs simultaneously on different hypervisors: bhyve, XEN, KVM, QEMU, NVMM, VirtualBox (the list will be expanded);\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eThe \u003cstrong\u003eMyBee-QT\u003c/strong\u003e project focuses on maximum simplicity for the user, for this reason, a huge number of \u003cstrong\u003eCBSD\u003c/strong\u003e features and complex configuration cases are ignored. If you are missing any features:\u003c/p\u003e\n\u003cul dir=\"auto\"\u003e\n\u003cli\u003ereview the roadmap, perhaps it is planned in the very near future;\u003c/li\u003e\n\u003cli\u003efile an Issue/Feature request - perhaps it should be added to the roadmap if it is in demand by the majority;\u003c/li\u003e\n\u003cli\u003econsider using \u003cstrong\u003eCBSD\u003c/strong\u003e (maximum features) directly or use the WEB UI to CBSD in the form of \u003ca href=\"https://clonos.convectix.com\" rel=\"nofollow\"\u003eClonOS\u003c/a\u003e;\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch3 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eGUI\u003c/h3\u003e\u003ca id=\"user-content-gui\" class=\"anchor\" aria-label=\"Permalink: GUI\" href=\"#gui\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003e\u003ca target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https://camo.githubusercontent.com/5222698b6eb4fe88b2fb6160817b34948bcedb4fcb2c6279026deadbd227146b/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d71742d6f766572766965772e706e673f7261773d74727565\"\u003e\u003cimg src=\"https://camo.githubusercontent.com/5222698b6eb4fe88b2fb6160817b34948bcedb4fcb2c6279026deadbd227146b/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d71742d6f766572766965772e706e673f7261773d74727565\" alt=\"mybee-qt-overview.png\" data-canonical-src=\"https://myb.convectix.com/img/mybee-qt-overview.png?raw=true\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eThe application view can work in two modes - 'DesktopPC' mode (on the screenshot) and mobile device mode (compact). The main screen contains the following elements:\u003c/p\u003e\n\u003col dir=\"auto\"\u003e\n\u003cli\u003eThe main menu of application settings'\u003c/li\u003e\n\u003cli\u003eThe list of hosters that you manage and use resources to create virtual environments. The application on the screenshot uses three nodes - 'rio' - a server running via RestAPI (can be running FreeBSD/XigmaNAS/DragonFlyBSD/Linux/MyBee OS),\n'bravo' - running via SSH (can be running FreeBSD/XigmaNAS/DragonFlyBSD/Linux/MyBee OS) and finally, a local computer via the \u003ccode\u003ecbsd\u003c/code\u003e interpreter.\u003c/li\u003e\n\u003cli\u003evirtual environments. These can be VMs running bhyve, KVM, QEMU, XEN, NVMM, VirtualBox hypervisors or containers running Jail, SystemD-nspawn, Docker/Containerd..\u003c/li\u003e\n\u003cli\u003eButton to launch the wizard for creating a new virtual environment;\u003c/li\u003e\n\u003cli\u003eControls for the selected virtual environment (also available via the context menu on the environment name);\u003c/li\u003e\n\u003cli\u003eText console or SSH terminal directly into the virtual environment - available if the target environment supports console login;\u003c/li\u003e\n\u003cli\u003eGraphical console directly into the virtual environment - available if the target environment supports VNC or RDP access (windows, ubuntu-desktop, kali, ghostbsd, etc.). Some containers may also offer graphical access.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp dir=\"auto\"\u003e\u003ca target=\"_blank\" rel=\"noopener noreferrer nofollow\" href=\"https://camo.githubusercontent.com/66f2ebf561c72043d27764bf474de7a0af2f16512a2b5f2732e1db50acc39fff/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d67726170682d6a61696c2e706e67\"\u003e\u003cimg src=\"https://camo.githubusercontent.com/66f2ebf561c72043d27764bf474de7a0af2f16512a2b5f2732e1db50acc39fff/68747470733a2f2f6d79622e636f6e7665637469782e636f6d2f696d672f6d796265652d67726170682d6a61696c2e706e67\" alt=\"mybee-graph-jail.png\" data-canonical-src=\"https://myb.convectix.com/img/mybee-graph-jail.png\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003cp dir=\"auto\"\u003eFor example, here is a demonstration of launching and displaying the game \u003ca href=\"/myb-project/mybee-qt/blob/main/Vanilla-Conquerer\" title=\"original Command\u0026amp;Conqueror\"\u003ehttps://github.com/TheAssemblyArmada/Vanilla-Conquer\u003c/a\u003e from a jail container on the FreeBSD operating system.\nBy pressing the 'F11' button, you can switch the graphical console to full-screen mode and thus get something similar to VDI. If you allow the container or virtual machine to use the GPU, which will greatly increase the performance of the graphics system, you can distribute/share and work in graphical containers and virtual machines with comfort.\u003c/p\u003e\n\u003col start=\"8\" dir=\"auto\"\u003e\n\u003cli\u003eContext menu with a set of auxiliary operations, such as setting filters for a selective list of virtual environments.\u003c/li\u003e\n\u003cli\u003eThe application workspace, at different times can show different information - graphs/telemetry of system load, graphical or text console, just debug/log of the application, etc.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eSystem Requirements\u003c/h2\u003e\u003ca id=\"user-content-system-requirements\" class=\"anchor\" aria-label=\"Permalink: System Requirements\" href=\"#system-requirements\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cul dir=\"auto\"\u003e\n\u003cli\u003eAndroid mobile or Linux or FreeBSD desktop environment;\u003c/li\u003e\n\u003cli\u003e1 cpu, 256 MB RAM;\u003c/li\u003e\n\u003cli\u003e~64 MB storage;\u003c/li\u003e\n\u003cli\u003eaccess to CBSD infrastructure mirrors to obtain gold/ISO images ( optional \u003ca href=\"https://github.com/cbsd/mirrors\"\u003eif you set up your own cache/mirror\u003c/a\u003e );\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eRoadmap\u003c/h2\u003e\u003ca id=\"user-content-roadmap\" class=\"anchor\" aria-label=\"Permalink: Roadmap\" href=\"#roadmap\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003ePlanned features in the next version:\u003c/p\u003e\n\u003cul dir=\"auto\"\u003e\n\u003cli\u003ereconfiguration of virtual environment characteristics;\u003c/li\u003e\n\u003cli\u003edisplay of graphs/telemetry of virtual machines and hosts (CPU, Memory, Storage/Network I/O);\u003c/li\u003e\n\u003cli\u003eIOS, MacOS, Windows port (help from porters or donors (including hardware) is welcome);\u003c/li\u003e\n\u003cli\u003egetting rid of 'root' privileges on those hypervisors where possible;\u003c/li\u003e\n\u003cli\u003eintegration with \u003ca href=\"https://github.com/polkit-org/polkit\"\u003ePolkit\u003c/a\u003e;\u003c/li\u003e\n\u003cli\u003emigration and cloning of virtual environments between hypervisors/nodes;\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eMyBee-QT Handbook\u003c/h2\u003e\u003ca id=\"user-content-mybee-qt-handbook\" class=\"anchor\" aria-label=\"Permalink: MyBee-QT Handbook\" href=\"#mybee-qt-handbook\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cul dir=\"auto\"\u003e\n\u003cli\u003e\u003ca href=\"/myb-project/mybee-qt/blob/main/docs/en/get-myb-qt.md\"\u003eGetting, installation and initial setup\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"/myb-project/mybee-qt/blob/main/docs/en/myb-qt-cbsd-local.md\"\u003eMode N1: local, CBSD interpreter\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"/myb-project/mybee-qt/blob/main/docs/en/myb-qt-cbsd-ssh.md\"\u003eMode N2: via SSH protocol, CBSD interpreter/MyBee\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"/myb-project/mybee-qt/blob/main/docs/en/myb-qt-cbsd-api.md\"\u003eMode N3: via RestAPI/MyBee\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"markdown-heading\" dir=\"auto\"\u003e\u003ch2 tabindex=\"-1\" class=\"heading-element\" dir=\"auto\"\u003eSponsor this project\u003c/h2\u003e\u003ca id=\"user-content-sponsor-this-project\" class=\"anchor\" aria-label=\"Permalink: Sponsor this project\" href=\"#sponsor-this-project\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath d=\"m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003c/div\u003e\n\u003cp dir=\"auto\"\u003eIf you like this project, want to say thank you and support us, please use:\u003c/p\u003e\n\u003cp dir=\"auto\"\u003e\u003ca href=\"https://www.patreon.com/clonos\" rel=\"nofollow\"\u003e\u003cimg src=\"https://camo.githubusercontent.com/671020107c9688451b5d495af4e4a9807e8550d452d2411aa8f134858e71afb3/68747470733a2f2f63352e70617472656f6e2e636f6d2f65787465726e616c2f6c6f676f2f6265636f6d655f615f706174726f6e5f627574746f6e4032782e706e67\" alt=\"Patreon donate button\" data-canonical-src=\"https://c5.patreon.com/external/logo/become_a_patron_button@2x.png\" style=\"max-width: 100%;\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003c/article\u003e","loaded":true,"timedOut":false,"errorMessage":null,"headerInfo":{"toc":[{"level":1,"text":"MyBee-QT: cross-platform GUI client for CBSD","anchor":"mybee-qt-cross-platform-gui-client-for-cbsd","htmlText":"MyBee-QT: cross-platform GUI client for CBSD"},{"level":2,"text":"Welcome to MyBee-QT","anchor":"welcome-to-mybee-qt","htmlText":"Welcome to MyBee-QT"},{"level":3,"text":"GUI","anchor":"gui","htmlText":"GUI"},{"level":2,"text":"System Requirements","anchor":"system-requirements","htmlText":"System Requirements"},{"level":2,"text":"Roadmap","anchor":"roadmap","htmlText":"Roadmap"},{"level":2,"text":"MyBee-QT Handbook","anchor":"mybee-qt-handbook","htmlText":"MyBee-QT Handbook"},{"level":2,"text":"Sponsor this project","anchor":"sponsor-this-project","htmlText":"Sponsor this project"}],"siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2Fmyb-project%2Fmybee-qt"}},{"displayName":"LICENSE","repoName":"mybee-qt","refName":"main","path":"LICENSE","preferredFileType":"license","tabName":"MIT","richText":null,"loaded":false,"timedOut":false,"errorMessage":null,"headerInfo":{"toc":null,"siteNavLoginPath":"/login?return_to=https%3A%2F%2Fgithub.com%2Fmyb-project%2Fmybee-qt"}}],"overviewFilesProcessingTime":0}},"appPayload":{"helpUrl":"https://docs.github.com","findFileWorkerPath":"/assets-cdn/worker/find-file-worker-7d7eb7c71814.js","findInFileWorkerPath":"/assets-cdn/worker/find-in-file-worker-708ec8ade250.js","githubDevUrl":null,"enabled_features":{"copilot_workspace":null,"code_nav_ui_events":false,"react_blob_overlay":false,"accessible_code_button":true,"github_models_repo_integration":false}}}}

Repository files navigation

MyBee-QT: cross-platform GUI client for CBSD

English | Español | Français | Deutsch | Русский | 中文 |


ℹ️ This guide covers the administration and use of MyBee-QT, a graphical client for CBSD (and MyBee OS).


Welcome to MyBee-QT

(*) What is MyBee-QT: it is a cross-platform QT-based application that provides a graphical interface for working with virtual machines and containers (creation, deletion, start and stop) on those platforms where CBSD can work.

It supports three modes:

  1. locally (similar to the virsh or VirtualBox mode): you install it on your Desktop computer running Linux or BSD and work locally with virtual environments. In this case, MyBee-QT works directly with the cbsd interpreter via shell;

  2. remotely via a simple RestAPI service: you use your Desktop computer (it can be a mobile device, such as a phone) as a thin client and work with a Linux or FreeBSD server on which CBSD and RestAPI to it are installed.

  3. remotely via SSH with the cbsd interpreter via shell (similar to how virt-manager works): the method is close to point 1, but SSH is added as a transport. This method does not require additional installation of the RestAPI service and turns any server running Linux/FreeBSD and OpenSSH into a host for your virtual environments.

mybee-qt-overview2.png

You are not limited to using any one method - one copy of MyBee-QT can serve both local environments and RestAPI/OpenSSH-only systems at the same time.

(*) What is CBSD: it is a cross-platform (FreeBSD, Linux, DragonFlyBSD) library (set of scripts) for low-level work with virtual environments (creation, deletion, launch and shutdown) working with hypervisors such as: bhyve, KVM, QEMU, XEN, VirtualBox, as well as lightweight containers based on jail technology. By installing the CBSD package on any Linux or FreeBSD node, you get the ability to use hypervisors and node resources for virtual machines, creating them in the GUI. The MyBee-QT application owes its appearance to the CBSD project and its community, since the development was sponsored by the CBSD donation fund.

(*) What is MyBee OS: this is an experimental distribution (two variants - based on Linux/Debian and FreeBSD) with pre-installed CBSD, RestAPI and OpenSSH services, optimized for creating virtual environments. It was created as a PoC, demonstrating that having bare metal without any OS, within 5 minutes you can already start working in virtual machines using server resources (~1-2 minutes takes the firmware of the MyBee hypervisor, then everything depends on the speed of your Internet connection). However, in addition to the demo nature, the distribution can find applications in trusted environments.

With MyBee-QT, the user can get a hybrid cloud consisting of various Linux, FreeBSD, DragonFlyBSD (the list will be expanded) systems that run VMs simultaneously on different hypervisors: bhyve, XEN, KVM, QEMU, NVMM, VirtualBox (the list will be expanded);

The MyBee-QT project focuses on maximum simplicity for the user, for this reason, a huge number of CBSD features and complex configuration cases are ignored. If you are missing 95BF any features:

  • review the roadmap, perhaps it is planned in the very near future;
  • file an Issue/Feature request - perhaps it should be added to the roadmap if it is in demand by the majority;
  • consider using CBSD (maximum features) directly or use the WEB UI to CBSD in the form of ClonOS;

GUI

mybee-qt-overview.png

The application view can work in two modes - 'DesktopPC' mode (on the screenshot) and mobile device mode (compact). The main screen contains the following elements:

  1. The main menu of application settings'
  2. The list of hosters that you manage and use resources to create virtual environments. The application on the screenshot uses three nodes - 'rio' - a server running via RestAPI (can be running FreeBSD/XigmaNAS/DragonFlyBSD/Linux/MyBee OS), 'bravo' - running via SSH (can be running FreeBSD/XigmaNAS/DragonFlyBSD/Linux/MyBee OS) and finally, a local computer via the cbsd interpreter.
  3. virtual environments. These can be VMs running bhyve, KVM, QEMU, XEN, NVMM, VirtualBox hypervisors or containers running Jail, SystemD-nspawn, Docker/Containerd..
  4. Button to launch the wizard for creating a new virtual environment;
  5. Controls for the selected virtual environment (also available via the context menu on the environment name);
  6. Text console or SSH terminal directly into the virtual environment - available if the target environment supports console login;
  7. Graphical console directly into the virtual environment - available if the target environment supports VNC or RDP access (windows, ubuntu-desktop, kali, ghostbsd, etc.). Some containers may also offer graphical access.

mybee-graph-jail.png

For example, here is a demonstration of launching and displaying the game https://github.com/TheAssemblyArmada/Vanilla-Conquer from a jail container on the FreeBSD operating system. By pressing the 'F11' button, you can switch the graphical console to full-screen mode and thus get something similar to VDI. If you allow the container or virtual machine to use the GPU, which will greatly increase the performance of the graphics system, you can distribute/share and work in graphical containers and virtual machines with comfort.

  1. Context menu with a set of auxiliary operations, such as setting filters for a selective list of virtual environments.
  2. The application workspace, at different times can show different information - graphs/telemetry of system load, graphical or text console, just debug/log of the application, etc.

System Requirements

  • Android mobile or Linux or FreeBSD desktop environment;
  • 1 cpu, 256 MB RAM;
  • ~64 MB storage;
  • access to CBSD infrastructure mirrors to obtain gold/ISO images ( optional if you set up your own cache/mirror );

Roadmap

Planned features in the next version:

  • reconfiguration of virtual environment characteristics;
  • display of graphs/telemetry of virtual machines and hosts (CPU, Memory, Storage/Network I/O);
  • IOS, MacOS, Windows port (help from porters or donors (including hardware) is welcome);
  • getting rid of 'root' privileges on those hypervisors where possible;
  • integration with Polkit;
  • migration and cloning of virtual environments between hypervisors/nodes;

MyBee-QT Handbook

Sponsor this project

If you like this project, want to say thank you and support us, please use:

Patreon donate button

0