Vinsta: Virtual Instance Network Solution and Technology Automation

Introduction

Vinsta empowers you to automate the provisioning, configuration, and management of virtual machine (VM) networks, streamlining your technology infrastructure. With Vinsta, you can:

• Simplify VM network setup with intuitive tools and pre-configured templates.
• Automate repetitive tasks, saving time and reducing human error.
• Manage complex VM network configurations efficiently.
• Improve network reliability and security through automated best practices.

Key Features

• VM Network Provisioning: Create and manage virtual networks for your VMs, eliminating manual configuration steps.
• Network Automation: Automate tasks like IP address assignment, subnet creation, firewall rules, and more.
• Pre-configured Templates: Leverage pre-built templates to set up common network configurations quickly.
• Security Automation: Establish and enforce network security policies for enhanced VM protection.
• Monitoring and Reporting: Gain insights into your VM network health and performance.
• Scalability: Manage large-scale VM deployments with ease.

Getting Started

Prerequisites

• Operating System: (Linux)
• Software: (QEMU,KVM)
• Network: (NAT, BRIDGE(br0))

Installation

0. Install bun:

   curl -fsSL https://bun.sh/install | bash # for macOS, Linux, and WSL

1. Clone the repository:

   git clone https://github.com/koompi/vinsta.git

2. Navigate to the project directory:

   cd vinsta

3. Install dependencies:

   bun install

4. Build vinsta:

   bun run build

5. Start vinsta:

   bun run start

Basic API Usage

Create a Virtual Machine

POST /api/create

{
    "name": "koompi-vm-1",
    "iso": "koompi",
    "ram": "4096",
    "disk": "15G",
    "cpu": "2",
    "network": "br10",
    "bootOption": "uefi",
    "arch": "x64"
}

Clone a Virtual Machine

POST /api/clone

{
  "image": "koompi",
  "name": "koompi-vm1",
  "ram": "8192",
  "disk": "100G",
  "cpu": "8"
}

Start a Virtual Machine

POST /api/start

{
  "name": "koompi-vm1",
}

Stop a Virtual Machine

POST /api/stop

{
  "name": "koompi-vm1",
}

Remove a Virtual Machine

POST /api/remove

{
  "name": "koompi-vm1",
}

Check Info of the Virtual Machine

POST /api/checkinfo

{
  "name": "koompi-vm1",
}

List all of the Virtual Machine

GET /api/listall

{
}

Access Rest API UI Client

http://localhost:3333

Documentation

For detailed documentation, please visit Vinsta Documentation.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a pull request.

License

Distributed under the MIT License. See LICENSE for more information.

Community

Join the Vinsta community to share your experiences and get support:

• Forum
• Chat

Acknowledgments

WORK IN PROGRESS