Install & requirements
Requirements
Section titled “Requirements”| What | Needed |
|---|---|
| macOS | 15 (Sequoia) or later |
| Mac | Apple Silicon (M1 or later). Intel Macs are not supported |
| Disk | about 2 GB for the app and the first OS image, plus the disks of your VMs |
| Memory | every VM reserves its memory while it runs; a small cluster needs several GB |
| Network | for the first start (OS image download) and the licence check; the lab itself works offline |
No Docker, no Homebrew and no other runtime are needed. The VMs run on Apple’s Virtualization framework.
Install
Section titled “Install”- Download the disk image from the Download page and open it.
- Drag the app into the Applications folder.
- Open it from Applications.
The first start
Section titled “The first start”On the first start the app shows a short setup sheet and then creates your lab:
- It checks that the ports it needs are free (by default 18580 and 18581 over TCP and 18582 over UDP). If another lab uses them, it picks the next free block (18680–18682, and so on).
- It downloads the current Debian cloud image for arm64 (about 290 MB), checks it against Debian’s published checksums and keeps it for later labs. The progress is shown in the sheet.
- It writes the lab’s configuration to
~/Library/Application Support/ownpaas/and keeps the tokens in your login Keychain. - It registers the engine as a LaunchAgent, so the lab keeps running when you close the window and starts again when you log in. macOS may ask you to allow it under System Settings › General › Login Items.
When the sheet closes, the lab answers and you have a first project called default.
Where things live
Section titled “Where things live”| Path | What |
|---|---|
/Applications/Ownpaas.app | the app, including the engine binaries |
~/Library/Application Support/ownpaas/ | the lab: configuration (ownpaas.yaml), database, VM disks, OS images |
~/Library/Logs/ownpaas/engine.log | the engine’s log |
| login Keychain | tokens of the lab and of your cloud accounts |
Uninstall removes all of it.