Skip to content

πŸ–₯️ Build lightweight VM sandboxes with QEMU and HVF acceleration using Zig for an efficient development environment on macOS.

Notifications You must be signed in to change notification settings

Manuvera14/kage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌟 kage - A Simple VM Sandbox for Everyone

πŸš€ Getting Started

Welcome to kage! This application allows you to run virtual machines easily on your macOS. Using powerful features like QEMU with HVF acceleration, you can create and manage lightweight virtual environments effortlessly.

πŸ“₯ Download kage

Download kage

To get started, you need to download the latest version of kage. Visit this page to download: kage Releases.

πŸ“‚ System Requirements

Before you install kage, ensure your system meets these requirements:

  • macOS (Latest version recommended)
  • At least 4 GB of RAM
  • A modern CPU that supports hardware virtualization
  • Sufficient disk space for virtual machines

πŸ› οΈ Installation Steps

Follow these steps to install kage on your macOS.

  1. Visit the Release Page: Click this link to download the latest version: kage Releases.
  2. Download the Package: On the Releases page, find the latest version and click the package link to download it.
  3. Locate the Downloaded File: Once downloaded, navigate to your Downloads folder or the location where your browser saves files.
  4. Unzip the Package: If the package is zipped, double-click it to unzip.
  5. Move the Application: Drag the kage application to your Applications folder to install it.

πŸ–₯️ Running kage

To run kage for the first time:

  1. Open Applications: Go to your Applications folder and find kage.
  2. Launch kage: Double-click the kage icon. macOS may ask if you are sure you want to open it since it was downloaded from the internet. Click "Open" to proceed.
  3. Grant Permissions: If prompted, allow kage to access the necessary network and disk resources.
  4. Begin Using kage: You will see the command line interface where you can start managing your virtual machines.

βš™οΈ How to Create a Virtual Machine

Creating a virtual machine is simple:

  1. Open kage.
  2. Use the command vmctl create <vm-name> to create a new virtual machine, replacing <vm-name> with your desired name.
  3. To start the virtual machine, use the command vmctl start <vm-name>.

πŸ’‘ Tips for Using kage

  • Documentation: Check the official documentation for advanced features and troubleshooting.
  • Community Support: Join the kage community forum for quick help from other users.
  • Back Up Regularly: Always back up your virtual machines to avoid data loss.

πŸ”§ Troubleshooting

If you encounter issues while using kage, here are some common solutions:

  • Not Launching: Ensure your macOS supports hardware virtualization.
  • Slow Performance: Check if your system has enough RAM and close unnecessary applications.
  • Error Messages: Make note of any error messages, as they can guide you to a solution.

πŸ“£ Feedback and Contributions

Your feedback is valuable. If you have suggestions or need assistance, please open an issue in this repository. Contributions are welcome! If you wish to contribute, please follow the guidelines in the repository.

🌐 Additional Resources

  • Official QEMU Documentation: Learn about the underlying technology.
  • Zig Language: Discover the programming language used to build kage.

Thank you for choosing kage! Happy virtual machine creating!

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •