Skip to content

vasillieux/vlab-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vlab

  • want to just get stuff done with no obselete dependencies when running your new qemu/docker/server lab?
  • wanna to get specific package but don't want to setup it few hours just to test something?
  • you're not sure that your lab-system is safe?
  • just browse interesting scripts?
 /\_/\           
( o o )   go ahead!
==_Y_==    check demo and quick start!
  `-'      

Demo

Check the demo! This is fresh-setuped Ubuntu 25.04 via lima. Vlab's helping to perform all quick checks and setup neccessary software, even with hard compilation process

demo

Screenshots

1

features

  • cross-distro support: works on ubuntu, arch, and nixos using the native package manager.
  • modular design: logic is separated into a controller, installer modules, and os-specific definitions.
  • targeted installation: install only the toolsets you need (recon, wifi, general, evm, docker).
  • sandbox verification: analyzes the running environment to detect potential isolation weaknesses and provides hardening advice.
  • .sh only no other deps.
  • user-defined modules: install via remote repos
  • security: verification 3rd party modules with hash

prerequisites

  • a supported os: ubuntu (debian-based), arch linux, or nixos.
  • root or sudo privileges. (for now..)
  • an active internet connection.

usage

install in one-line command

curl -fsSL https://raw.githubusercontent.com/vasillieux/vlab-toolkit/main/bootstrap.sh | sudo bash

after you can use the same command to call vlab.sh or call it directly
sudo /usr/share/vlab/core/vlab.sh

addons

You can install additional modules via vlab's menu
The recommended (yet empty) repo is:

https://github.com/vasillieux/vlab-modules-community

todo

  • snapshots
  • more default and non-default stuff, kinda weirdo labs. suggest this requires catalogue..
  • linking, prebuilt docker images for weird project
  • setup vpn, rdp, and stuff.
  • simpler clone&usage, better oneliner

disclaimer

this toolkit installs security software. use it responsibly and only on systems you are authorized to test. the authors are not responsible for any misuse.