From a66bd0a921dc6b2de3db4de424e6150ad28c29fc Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Tue, 7 Apr 2020 13:42:45 +0300 Subject: Add: README.md, heippa.yaml --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..87a812f --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# Contractor -- build software (more) securely + +The Contractor lets you build software with less worry that it will +do something bad. This is an ugly proof of concept prototype and +certainly not ready for real use. + +This will probably only work on Debian 10 (buster) and later. To use, +you need to have libvirt and vmdb2. + +* Create two VM images (this can take a while): + + `sudo ./vm.sh` + +* Create the outer, manager VM: + + `./vm-libvirt.sh` + +* Find out what the IP address of the VM is: + + `less /var/lib/libvirt/dnsmasq/virbr0.status` + +* Clone the test repo: + + `git clone git://git.liw.fi/heippa /tmp/heippa` + +* Build (change IP to yours; this will take a while to run): + + `./contractor -v -m 192.168.100.63 -- build heippa.yaml` + +* Hopefully all went well. + +Read contractor.md for more information; formatted versions: + +* [HTML](https://files.liw.fi/temp/contractor.html) +* [PDF](https://files.liw.fi/temp/contractor.pdf) -- cgit v1.2.1