https://github.com/ms-jpq/mol

Minimal hardware accelerated `curl -- linux.iso | qemu-system-aarch64` scripts.
https://github.com/ms-jpq/mol

Last synced: about 1 month ago
JSON representation

Minimal hardware accelerated `curl -- linux.iso | qemu-system-aarch64` scripts.

• Host: GitHub
• URL: https://github.com/ms-jpq/mol
• Owner: ms-jpq
• Created: 2023-07-28T18:59:10.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-01-06T17:04:51.000Z (10 months ago)
• Last Synced: 2024-01-07T17:52:23.584Z (10 months ago)
• Language: Shell
• Homepage:
• Size: 35.2 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# MoL

Minimal hardware accelerated `curl -- ubuntu.iso | qemu-system-aarch64` scripts.

- SSH connection

- ROOT password (root)

- ROOT partition expansion

## Dependencies

```bash

brew install -- qemu bash gnu-getopt make flock socat

```

## Usage

```bash

# The `--` are required to distinguish convenience / raw qemu args

./main.sh ACTION [-n --name NAME='vm'] [-f --fork UPSTREAM] [--os OS] [--vnc] -- ...convenience args -- ...raw qemu args

```

| Action           | Description                                                      |

| ---------------- | ---------------------------------------------------------------- |

| `n` \| `new`     | create VM, optionally from `--fork UPSTREAM`                     |

| `r` \| `run`     | run VM                                                           |

| `l` \| `ls`      | list VMs                                                         |

| `rm` \| `remove` | remove VM                                                        |

| `pin`            | protect VM from `rm`                                             |

| `unpin`          | safety-off                                                       |

| `c` \| `console` | connect to VM serial console (only if VM is started without one) |

| `s` \| `ssh`     | connect to VM via SSH                                            |

| `m` \| `monitor` | connect to qemu text console                                     |

| `v` \| `vnc`     | connect to VNC display (if VM was provisioned one)               |

| `q` \| `qmp`     | connect to qemu JSON console                                     |

### Convenience Arguments

| Arg     | Description | Default           |

| ------- | ----------- | ----------------- |

| `--cpu` | # cores     | physical cpus / 2 |

| `--mem` | memory      | 1G                |

## Files

`./main.sh` will create a VM @ `./var/$NAME.$OS.vm` (ROOT)

- `$ROOT/ssh.conn` in addition to console output will contain the path of SSH socket

- `rm` on a running VM will fail. Running VMs are protected via `flock $ROOT`

## Serial Console

- You will have to **PRESS THE ENTER KEY** before you see anything, the OS is waiting for your input.

- `root` user's password is `root`