HanaLima
GitHub
HanaLima icon ● v0.6.0 · macOS 26+ · Lima 2.2+ · MIT

Lima VMs,
point and click.
Bridges without sudo. Lima の VM を、
GUI でかんたんに。
ブリッジもsudo なしで。

HanaLima is a native SwiftUI app that drives limactl. Size your CPUs, memory and disks, wire up NAT, host-only and bridged networks with fixed IPs, and live in a real console — no root, no socket_vmnet, no sudoers file. HanaLima は limactl を操作するネイティブの SwiftUI アプリです。CPU・メモリ・ディスクを割り当て、NAT・ホストオンリー・ブリッジのネットワークを固定 IP 付きで組み、そのままコンソールで作業できます。root も socket_vmnet も sudoers も要りません。

Build it in 3 commands3 つのコマンドでビルド → How is that possible?なぜ実現できるのか
Swift 6 strict concurrency vmnet macOS 26 API 0 sudo prompts* unofficial · not affiliated with Lima
hanalima-dev
OverviewConsoleSettingsLog
VIRTUAL MACHINES
hanalima-dev
k8s-node-1
ubuntu-lts
STORAGE
⌁ Disks
NETWORKS
✿ Virtual networks
NIC 1demo NAT 192.168.200.10 fixed
NIC 2lan bridge en0 192.168.100.13
lima-hanalima-dev$ ip -4 -br addr lo UNKNOWN 127.0.0.1/8 eth0 UP 192.168.5.15/24 lima0 UP 192.168.200.10/24 # fixed lima1 UP 192.168.100.13/24 # LAN lima-hanalima-dev$
0sudo prompts for NAT, host-only and bridged networks*NAT・ホストオンリー・ブリッジで必要な sudo の回数*
3network kinds, each with its own launchd-activated helper種類のネットワーク。どれも launchd が起動するヘルパーで提供
4 Bbig-endian length + Ethernet frame: the whole wire protocolビッグエンディアンの長さ＋フレーム。プロトコルはこれだけ
0patches to Lima. It's all limactl and its JSONLima への改造。すべて limactl とその JSON で動く

* Tested on macOS 27.0.1 with an ad-hoc signed helper carrying com.apple.security.virtualization. Lima's classic socket_vmnet networks still work for VMs that use them, but HanaLima doesn't need or install socket_vmnet. * macOS 27.0.1 で、com.apple.security.virtualization 付きの ad-hoc 署名のヘルパーで確認。Lima の従来方式（socket_vmnet）を使う VM もそのまま動きますが、HanaLima 自体は socket_vmnet を必要とせず、導入もしません。

// how it works

What makes HanaLima possibleHanaLima だからできること、その理由

No magic and no kernel extensions: a handful of macOS APIs used in a way most tools don't, plus some careful plumbing around Lima's public interfaces. 魔法もカーネル拡張もありません。多くのツールが使っていない macOS の API の使い方と、Lima の公開インターフェースまわりの丁寧な配管だけです。

01

macOS 26 vmnet_network + one entitlement = rootless NAT with your subnetmacOS 26 の vmnet_network と entitlement 1 つで、root なしの NAT

The new vmnet API lets a process create a NAT or host-only network with a subnet you choose and DHCP reservations — as an ordinary user, as long as the binary is signed with com.apple.security.virtualization. (In the figures, uid 501 is the Mac's first ordinary user account; root is uid 0.)新しい vmnet API なら、サブネットを指定した NAT やホストオンリーのネットワークを、DHCP 予約付きで一般ユーザーのまま作れます。条件は、バイナリが com.apple.security.virtualization 付きで署名されていること。（図の uid 501 は、Mac で最初に作られる一般ユーザーの ID です。root は uid 0。）

hanalima-netd
BEFORE · socket_vmnet従来 · socket_vmnetVMsocket_vmnetroot · sudoersroot · sudoers が必要vmnetfixed subnetサブネットは固定HANALIMA · hanalima-netdHANALIMA · hanalima-netdVMhanalima-netduid 501 · no sudouid 501 · sudo なし+ VM entitlement+ 仮想化の entitlementvmnet_network192.168.200.0/24DHCP: .10 reservedDHCP 予約: .10Your subnet, your fixed IPs — as an ordinary user.サブネットも固定 IP も、一般ユーザーのまま。
02

Bridging to the LAN — also without rootLAN へのブリッジも root なし

The classic bridged mode is what socket_vmnet runs as root. We found that, with the same entitlement, vmnet_start_interface in VMNET_BRIDGED_MODE starts fine as uid 501. One interface per VM; two VMs plus en0 share bridge100, and the Mac keeps its IPv4. Works over Wi-Fi too: bridged to en1, a VM got its address from the LAN's DHCP and reached the router through the access point.従来のブリッジモードは、socket_vmnet が root で動かしているものです。同じ entitlement があれば、VMNET_BRIDGED_MODE の vmnet_start_interface が uid 501 のまま起動することを確かめました。VM ごとにインターフェースを作り、2 台の VM と en0 が bridge100 を共有しても、Mac の IPv4 は維持されます。Wi-Fi でも動きます。en1 にブリッジした VM が LAN の DHCP からアドレスを取得し、アクセスポイント経由でルーターまで届きました。

bridge · en0 / Wi-Fi
LAN routerLAN のルーター192.168.100.1bridge100no sudosudo なしen0vmenet0vmenet1Mac192.168.100.4 ✓VM dev192.168.100.13VM web192.168.100.14hanalima-netd · uid 501 · 1 interface / VMhanalima-netd · uid 501 · VM ごとに 1 つkeeps its IPv4IPv4 はそのままClassic bridged mode, started with the entitlement instead of root.従来のブリッジモードを、root ではなく entitlement で起動。
03

Speaking socket_vmnet's protocol, so Lima needs no patchessocket_vmnet のプロトコルを話すので、Lima は無改造

Lima already knows how to plug a VM into a UNIX socket: networks: - socket: PATH. The protocol is QEMU's stream format — a 4-byte big-endian length, then the frame. hanalima-netd speaks it on one side and vmnet on the other. Works for VZ and QEMU VMs.Lima はもともと、VM を UNIX ソケットにつなげます（networks: - socket: PATH）。中身は QEMU の stream 形式で、4 バイトのビッグエンディアンの長さに続けてフレームを送るだけ。hanalima-netd は片側でこれを話し、反対側で vmnet を話します。VZ でも QEMU でも動きます。

lima.yaml
Lima VMunmodified無改造socket: pathlan.socksocket_vmnetroothanalima-netduid 501 → vmnetON THE WIRE · QEMU streamソケットの中身 · QEMU stream 形式00 00 05 eaEthernet frame · 1514 bytesイーサネットフレーム · 1514 バイトlength, 4 B BE長さ 4 バイトas-isそのままSame protocol as socket_vmnet: works for VZ and QEMU VMs.socket_vmnet と同じ形式なので、VZ でも QEMU でも動く。
04

launchd socket activation: networks outlive the applaunchd のソケットアクティベーションで、アプリを終了しても動き続ける

Each network is a per-user LaunchAgent whose socket launchd owns. The helper starts on the first VM connection and exits when idle. Quit HanaLima, run limactl start from a shell — the network is still there.ネットワークごとにユーザーの LaunchAgent を登録し、ソケットは launchd が持ちます。最初の VM 接続でヘルパーが起動し、使われなくなると終了します。HanaLima を終了して、シェルから limactl start しても、ネットワークはそのまま使えます。

LaunchAgent
HanaLima appHanaLima アプリlaunchd socketlaunchd のソケットhanalima-netdVM✕ quit✕ 終了listening on lan.socklan.sock で待ち受けidle → exit未使用 → 終了limactl start (from a shell)シェルから limactl startQuit the app — the network keeps running.アプリを終了しても、ネットワークは動き続ける。
05

Fixed IPs that actually stick: DHCP option 61 surgery固定 IP を本当に効かせる、DHCP オプション 61 の手術

vmnet reserves addresses by MAC, but macOS's bootpd identifies a client by its client identifier when one is present — and Linux guests send a DUID. So the reservation never matched. The helper strips option 61 from DHCP requests, only for MACs that have a reservation. With no client identifier, bootpd falls back to the MAC address, the reservation matches, and the VM gets its fixed IP.vmnet の予約は MAC で行いますが、macOS の bootpd はクライアント識別子があればそちらで識別し、Linux のゲストは DUID を送ってきます。そのため予約が一致しませんでした。ヘルパーは、予約のある MAC からの DHCP 要求に限って、オプション 61 を取り除きます。識別子がなくなると bootpd は MAC アドレスで相手を識別するので、予約が一致し、VM に固定 IP が割り当てられます。

DHCPClientIDFilter
AS SENTそのまま送るとDHCPREQUESTMAC 52:55…opt 61 DUIDbootpdID = DUID.37✗ no match✗ 予約と不一致HANALIMADHCPREQUESTMAC 52:55…opt 61✂bootpdID = MAC.10✓ reserved✓ 予約どおりnetd removes option 61 — only for MACs with a reservation.netd がオプション 61 を外す（予約のある MAC だけ）。Linux sends a DUID; bootpd prefers it over the MAC.Linux は DUID を送り、bootpd は MAC よりそれを優先する。
06

limactl is the API — and edits stay minimallimactl を API として使い、変更は最小限に

No Go code is linked; HanaLima reads limactl list --format json and the watch --json event stream. Form edits become limactl edit --set expressions for just the fields you touched, so Lima's defaults and your unknown keys survive, and Lima validates every change.Go のコードはリンクせず、limactl list --format json と watch --json のイベントを読みます。フォームの変更は、触った項目だけの limactl edit --set 式になるので、Lima の既定値や未知のキーは残り、変更はすべて Lima が検証します。

LimaKit
FORMフォームCPUsCPU2 → 4Memoryメモリ4 GiBDiskディスク100 GiBlimactl edit --set '.cpus = 4'Lima validates ✓Lima が検証 ✓lima.yaml# my notescpus: 4only thisここだけmemory: 4GiBmyTool: …keptそのままREWRITE THE FILEファイルごと書き換えると✗ defaults baked in✗ 既定値が書き込まれる✗ unknown keys,✗ 未知のキーやcomments lostコメントが消えるReads: list --format json, watch --json. No Go linked.読み取りは list --format json と watch --json。Go はリンクしない。
07

A VM's disk on an external drive — and back, anytimeVM のディスクを外付けドライブへ、いつでも行き来

Lima has no per-VM location, and it lists only real folders in ~/.lima: link a whole VM folder to another drive and the VM vanishes. So the folder stays and only disk, the one large file, moves out as a link Lima follows for start, resize and snapshots. The copy goes through copyfile with COPYFILE_DATA_SPARSE, which copies only the data extents, so the disk keeps its sparse size. The swap to the link is a single rename, so a failed or cancelled move leaves the original untouched.Lima には VM ごとの置き場所の設定がなく、一覧には ~/.lima の中の本物のフォルダしか出ません。VM のフォルダごと別のドライブへリンクすると、VM が消えてしまいます。そこでフォルダは残し、いちばん大きな disk だけをリンクで外へ出します。起動、拡張、スナップショットも Lima がリンクをたどってくれます。コピーは copyfile の COPYFILE_DATA_SPARSE で、データのある範囲だけを写すので、ディスクはスパースのままです。リンクへの置き換えは rename 1 回なので、失敗しても中止しても元のディスクは無傷です。

ExternalDisk
LIMA ON ITS OWN · link the folderLima だけで · フォルダごとリンク~/.lima/vm→ HDD (symlink)→ HDD（リンク）limactl list✗ the VM disappears✗ VM が一覧から消えるHANALIMA · only the disk movesHANALIMA · ディスクだけを移すMac · ~/.lima/vmlima.yamllogs · socketsログ・ソケットdisk → linkdisk → リンクHDD · APFSHanaLima Disks/vm/disk 274 MB / 20 GBmove移すback anytimeいつでも戻すListed, starts, resizes: Lima follows the link.一覧にも出て、起動も拡張もできる（Lima がリンクをたどる）。A plain cp fills every hole: 20 GB. HanaLima: 274 MB.単に cp すると穴が埋まって 20 GB。HanaLima なら 274 MB のまま。
08

Snapshots for VZ VMs, made of APFS clonesVZ の VM にもスナップショットを、APFS のクローンで

Lima 2.2's VZ driver has no snapshots. HanaLima makes its own: with the VM stopped, it clones disk and the EFI variable store with APFS clonefile. A clone shares every block with the disk until either one changes, so it takes a moment and costs only what you write afterwards. Restoring clones it back with a single rename; the VM keeps its name, MAC addresses and fixed IPs. Clones work only within a volume, so snapshots sit on the disk's own volume.Lima 2.2 の VZ ドライバーにはスナップショットがありません。そこで HanaLima が自前で用意します。停止中に disk と EFI の変数ストアを APFS の clonefile で複製します。クローンは、どちらかが書き換わるまで中身をすべて共有するので、一瞬で終わり、容量はその後に書いた分だけです。戻すときはクローンを作り直して rename 1 回。VM の名前、MAC アドレス、固定 IP はそのままです。クローンは同じボリューム内でしか作れないので、スナップショットはディスクと同じボリュームに置きます。

DiskSnapshot
LIMA ON ITS OWN · a VZ VMLima だけで · VZ の VMlimactl snapshot create vm✗ unimplemented✗ 未対応HANALIMA · APFS CLONESHANALIMA · APFS のクローン■ written since■ その後に書いた分disksnapshotスナップsame blocks, shared同じブロックを共有Instant, and ~0 bytes until the disk changes.一瞬で、ディスクが変わるまで容量はほぼ 0。Restore = clone it back. Same name, MAC, fixed IP.戻す＝クローンを戻すだけ。名前・MAC・固定 IP はそのまま。Or start a new VM from it.そこから新しい VM も作れる。
09

Copies that are really separate — and know where they came from本当に独立したコピーを、コピー元の記録つきで

limactl clone copies a VM in a moment with APFS clones and gives it a new host name, MAC addresses and SSH keys. But it copies what it finds: the link to a disk on an external drive, so both VMs would write one disk; MAC addresses set by hand; the original's logs. HanaLima clones the moved disk on its drive, drops those MACs, empties the logs, and writes the parent's id into the copy's record. The Overview shows where each VM came from and its copies — even for copies and renames made with limactl itself.limactl clone は APFS のクローンで VM を一瞬で写し、ホスト名、MAC アドレス、SSH の鍵を新しくします。ただし、見つけたものはそのまま写します。外付けドライブにあるディスクへのリンク（2 台が 1 つのディスクに書き込むことに）、手で指定した MAC アドレス、元の VM のログ。HanaLima は、移したディスクをそのドライブの上でクローンし、その MAC を消し、ログを空にし、親の ID をコピーの記録に書きます。概要には、どの VM からコピーしたか、どんなコピーがあるかを表示します。limactl で直接行った複製や名前の変更も見分けます。

InstanceCopy
LIMA ON ITS OWN · limactl cloneLima だけで · limactl clonevm/disk → linkvm-copy/disk → linkHDD · vm/disk✗ two VMs, one disk✗ 2 台で 1 つのディスクHANALIMA · clone, then finish the jobHANALIMA · clone のあとを仕上げる✓ the moved disk → its own APFS clone on that drive✓ 移したディスク → そのドライブ上に専用のクローン✓ hand-set MACs dropped (no twins on the network)✓ 手で指定した MAC を消す（ネットワークに同じ MAC を出さない）✓ the original's logs emptied✓ 元の VM のログを空に✓ parent recorded → lineage and a note in Overview✓ 親を記録 → 概要に系譜とメモOne record per VM, parent only: any depth of copies stays cheap.記録は VM ごとに 1 つ、親だけを持つ。何世代でも軽いまま。
10

Installer ISOs on a Lima VM — install into Lima's own diskインストーラーの ISO でも Lima の VM に、Lima のディスクへ直接インストール

Lima boots only cloud images: it sets up a VM through cloud-init and waits for SSH, so an interactive installer never finishes. But a Lima VM is just files in ~/.lima/<name>/, and Lima reuses a disk and vz-efi that already exist. So HanaLima asks Lima for a VM with a 1 MiB placeholder image, which gives a blank disk of the size you chose; then it boots the ISO itself on Virtualization.framework, sharing Lima's disk, EFI variable store and machine identifier, and you install as usual in a window. One fix-up line in the installed OS installs cloud-init and resets it; from then on limactl start configures the VM like any other — user, key, guest agent, shares, provisioning.Lima が起動できるのはクラウドイメージだけです。cloud-init で VM を整えて SSH を待つ仕組みなので、対話式のインストーラーは終わりません。ところが Lima の VM は ~/.lima/<名前>/ のただのファイルで、すでにある disk と vz-efi は Lima がそのまま使います。そこで HanaLima は 1 MiB のダミーのイメージで Lima に VM を作らせ（選んだ大きさの空のディスクができます）、Virtualization.framework で ISO を自分で起動します。Lima のディスク、EFI の変数ストア、機械の識別子を共有したまま、ウインドウの中でいつもどおりインストールします。インストールした OS で仕上げの 1 行を実行すると cloud-init が入って初期状態になり、以後は limactl start がほかの VM と同じように設定します。ユーザー、鍵、ゲストエージェント、共有、プロビジョニングまで。

InstallerVM
LIMA ON ITS OWN · installer ISOLima だけで · インストーラーの ISOlimactl start✗ waits for SSH forever✗ SSH を待ち続けるHANALIMA · 3 steps, Lima's files all alongHANALIMA · 3 段階、ファイルはずっと Lima のもの1 · create1 · 作成1 MiB placeholder1 MiB のダミー→ blank disk, 20 GB→ 空の disk 20 GB2 · install (VZ)2 · インストール (VZ)ISO → Lima's diskISO → Lima の diskshared vz-efi, idvz-efi・識別子は共有3 · limactl start3 · limactl startcloud-init: user, key,cloud-init が設定:agent, sharesユーザー・鍵・共有sudo mount -L HANALIMA /mnt && sudo sh /mnt/limaify.shThe one fix-up line, typed in the installed OS: cloud-init + sshd, then "next boot is the first".仕上げの 1 行。cloud-init と sshd を入れ、「次が初回」にする。Ubuntu Server 26.04 verified: a regular Lima VM 7 s after the hand-over.Ubuntu Server 26.04 で確認。引き渡しの 7 秒後には普通の Lima の VM。

Compared with Lima on its ownLima だけで使う場合との比較

Lima (limactl)Lima（limactl）HanaLima
Create a VM from an installer ISOインストーラーの ISO から VM を作るcloud images onlyクラウドイメージのみyes · installs into Lima's diskyes · Lima のディスクに直接
Snapshots of VZ VMsVZ の VM のスナップショットnoyes · APFS clonesyes · APFS のクローン
A new VM from a snapshotスナップショットから新しい VMnoyes
A VM's disk on an external driveVM のディスクを外付けドライブにnoyes · stays sparseyes · スパースのまま
Copying a VM whose disk is on another driveディスクを別のドライブに置いた VM の複製both share one disk2 台で 1 つのディスクits own clone専用のクローン
Hand-set MAC addresses on a copyコピーの、手で指定した MAC アドレスcopied (duplicates)そのまま（重複）dropped消す
What a deleted VM leaves behind削除した VM が残すデータnot tracked把握しないlisted, deletable一覧にして削除できる
Where a copy came fromコピー元の記録—shown, with a note表示（メモつき）
// networking

The packet pathパケットの通り道

One helper process per network, one vmnet interface per VM. NAT and host-only networks are created on the first connection and released on the last — never reused, because a reused vmnet network can lose its DHCP reservations and even take the Mac's IPv4 with it. ネットワークごとにヘルパーが 1 プロセス、VM ごとに vmnet のインターフェースが 1 つ。NAT とホストオンリーのネットワークは最初の接続で作り、最後の切断で解放します。使い回しはしません。使い回した vmnet のネットワークは DHCP 予約を失い、Mac の IPv4 まで奪うことがあるためです。

LIMA VMs (VZ / QEMU) launchd + hanalima-netd vmnet HOST / LAN dev lima0 → demo.sock lima1 → lan.sock eth0: Lima user-mode web lima0 → lan.sock netd · demo NAT 192.168.200.0/24 DHCP opt 61 stripped netd · lan bridged to en0 1 interface per VM flock(net/vmnet.lock) serializes vmnet calls across helpers vmnet_network macOS 26 API DHCP + NAT · bridge101 VMNET_BRIDGED legacy API, no root vmenet0/1 · bridge100 Mac 192.168.200.1 NAT → internet LAN en0 · LAN DHCP 192.168.100.x
UNIX socket, QEMU stream framingUNIX ソケット（QEMU stream 形式） same, to the bridge helper同上（ブリッジのヘルパーへ） vmnet read/write, then the kernel bridgevmnet の読み書き、その先はカーネルのブリッジ

Compared with what Lima offers out of the boxLima に標準で用意されている方式との比較

user-mode vzNAT socket_vmnet HanaLima networks
Needs root / sudoersroot・sudoers が必要nonoyesno
Host can reach the guest IPホストからゲストの IP に届くnoyesyesyes
Choose the subnetサブネットを指定できるnonoyesyes
Fixed IP per VM (DHCP reservation)VM ごとの固定 IP（DHCP 予約）nono—yes
Bridge to the LANLAN へのブリッジnonoyesyes
Host-only networkホストオンリーnonoyesyes
Works when the GUI isn't runningGUI を起動していなくても動くyesyesyesyes
// features

Everything you'd expect from a VM managerVM 管理ソフトに期待するものを、ひととおり

Size the hardware, wire the networks, open a console — all from windows and forms, no YAML required (it's still there when you want it). In English or Japanese, following your Mac's language.ハードウェアの割り当ても、ネットワークの配線も、コンソールも、すべてウィンドウとフォームで。YAML を書く必要はありません（書きたいときは書けます）。表示は Mac の言語設定に合わせて英語か日本語で。

v0.1

Create & run作成と運用

Pick from all of Lima's templates, grouped by distribution with readable names — “Ubuntu 24.04 LTS”, “Debian (Latest: 13)”. Then CPUs, memory, disk, VZ or QEMU. Live state via limactl watch, and image downloads with percent, speed and time left — even though limactl prints no progress without a terminal.Lima のテンプレートを、ディストリビューションごとに「Ubuntu 24.04 LTS」「Debian（最新: 13）」のような名前で選べます。CPU、メモリ、ディスク、VZ／QEMU も選んで作成。limactl watch で状態をリアルタイム表示。イメージのダウンロードは、割合・速度・残り時間まで（端末なしでは limactl が進捗を出さないので、キャッシュの書き込みから計算）。

v0.1

Console that waits待ってくれるコンソール

An in-app terminal (SwiftTerm) that connects when the guest is actually ready, not when it merely says Running.アプリ内のターミナル（SwiftTerm）。「Running」の表示ではなく、ゲストの準備が本当に整ってから接続します。

v0.2

Settings, form or YAML設定はフォームでも YAML でも

NICs, shared folders, port forwards, or the raw lima.yaml — validated by Lima before it lands. While the VM runs, everything stays readable, just not editable.NIC、共有フォルダ、ポート転送。lima.yaml を直接編集しても、Lima の検証を通ってから反映されます。VM の実行中も、変更はできませんが内容はすべて閲覧できます。

v0.2

Disks, storage & external drivesディスク、使用量、外付けドライブ

Create, grow, delete and attach disks with limactl disk. See where Lima keeps VMs and downloaded images, the space each really uses (sparse-aware, like du), and which VM uses each downloaded image. Clear the ones no VM needs — Lima's own prune --keep-referred keeps anything a template mentions, so HanaLima decides itself. Keep a temporary VM's disk on an external drive: HanaLima checks the drive first (another volume, APFS, free space), moves only the disk while keeping it sparse, stops the VM from starting while the drive is away, and cleans up when you delete the VM. Snapshots count with their VM, and what a VM deleted with limactl left behind — snapshots, moved disks — is listed for you to delete.limactl disk でディスクの作成、拡張、削除、接続。VM やダウンロードしたイメージの置き場所と、実際に使っている容量（du と同じくスパースを考慮）、ダウンロードしたイメージをどの VM が使っているかを表示。どの VM も使っていないイメージだけを削除できます（Lima の prune --keep-referred はテンプレートが参照するものも残すので、HanaLima が自分で判定）。一時的な VM のディスクは外付けドライブへ。移動先を先に確かめ（別のボリューム、APFS、空き容量）、ディスクだけをスパースのまま移し、ドライブが外れていれば起動を止め、VM の削除で後片付けまで行います。スナップショットの容量は VM ごとに表示。limactl で直接削除した VM が残したスナップショットや外付けのディスクも一覧にして、削除できます。

v0.2

Menu bar & start at loginメニューバーとログイン時の起動

Every VM one click away; keeps running when the window closes. Per-VM start at login via limactl autostart.すべての VM にワンクリックで。ウィンドウを閉じても常駐。VM ごとのログイン時の起動は limactl autostart で。

v0.3

Rootless networksroot 不要のネットワーク

NAT and host-only with your subnet and fixed IPs; bridged to wired or Wi-Fi. Change or delete a network and each VM on it is told what to do next — restart, or drop a NIC that points nowhere. VMs on Lima's classic socket_vmnet networks keep working.サブネットと固定 IP を指定できる NAT とホストオンリー、有線・Wi-Fi へのブリッジ。ネットワークを変更・削除すると、それを使う VM ごとに次の操作（再起動、行き先のない NIC の削除）を案内。Lima の従来方式（socket_vmnet）を使う VM もそのまま動きます。

v0.4

Screen thumbnails画面のサムネイル

A live view of the screen in the Overview for VZ VMs with a display, via limactl screenshot.画面を有効にした VZ の VM は、limactl screenshot で画面を概要に表示。

v0.4

Logs & provisioningログとプロビジョニング

Follow the host agent log and serial consoles live, with search. Edit the provisioning scripts and data files Lima applies on every boot — in an editor that won't smart-quote your shell script. Or start from ready-made examples: basic tools, your dotfiles and public key, Docker Engine, and an XDP development toolchain.ホストエージェントのログとシリアルコンソールを、検索しながらリアルタイムに。Lima が起動のたびに適用するスクリプトやファイルも、スマート引用符に化けないエディタで編集。基本ツール一式、dotfiles・公開鍵、Docker Engine、XDP の開発環境といった例から、ワンクリックで始められます。

v0.4

English & Japanese英語と日本語

The whole UI — menus, sheets, error messages, plurals — in both languages, from a String Catalog. HanaLima follows your Mac's language, or pick one per app in System Settings.メニュー、シート、エラーメッセージ、複数形まで、UI のすべてを両方の言語で（String Catalog）。Mac の言語設定に従います。システム設定で HanaLima だけ別の言語にもできます。

v0.5

Snapshots for every VMどの VM にもスナップショット

Save the state of a stopped VM and return to it anytime — or start a new VM from it. VZ VMs, which Lima can't snapshot, get HanaLima's own: APFS clones of the disk, instant and taking space only as the disk changes. QEMU VMs use Lima's.停止中の VM の状態を保存し、いつでも戻せます。そこから新しい VM も作れます。Lima がスナップショットに対応していない VZ の VM は、HanaLima 独自の方式（ディスクの APFS クローン。一瞬で、容量は変わった分だけ）。QEMU の VM は Lima のものを使います。

v0.5

Copies with a family treeコピー元がわかる複製

Copy a stopped VM in a moment. The copy gets a new name, host name, MAC addresses and SSH keys, and its own disk even on an external drive. Each VM shows where it came from, its copies, and a note you write.停止中の VM を一瞬で複製。名前、ホスト名、MAC アドレス、SSH の鍵は新しくなり、外付けドライブにあるディスクも専用のものになります。VM ごとに、コピー元、コピー、メモを表示します。

v0.5

Keep your Mac's files out of reachMac のファイルを VM から見せない

Lima shares your home folder with every VM, read-only, so a VM can read ~/.ssh. Turn that off when creating a VM that runs something you don't fully trust, like an AI coding agent, and share just one work folder instead — the only part of your Mac it can see. That hides files, not the network: the VM can still reach the internet, your LAN and services on the Mac's 127.0.0.1.Lima は既定でホームフォルダを読み取り専用ですべての VM と共有するので、VM から ~/.ssh などが読めます。AI のコーディングエージェントなど、信頼しきれないものを動かす VM は、作成時にこの共有を外し、代わりに作業フォルダを 1 つだけ共有できます。VM から見える Mac のファイルは、そのフォルダだけになります。ただし隠せるのはファイルで、ネットワークは別です。VM からはインターネット、LAN、Mac の 127.0.0.1 で動いているサービスに届きます。

v0.6

Create from an installer ISOインストーラーの ISO から作成

Pick a Linux installer ISO instead of a template. HanaLima boots it in its own window, installs straight into the VM's disk, and after a one-line fix-up hands the VM to Lima, which configures it like any other. Ubuntu Server 26.04 verified; VZ only.テンプレートの代わりに Linux のインストーラーの ISO を選べます。HanaLima が専用のウインドウで起動し、VM のディスクに直接インストールします。仕上げの 1 行のあとは Lima に引き渡され、ほかの VM と同じように設定されます。Ubuntu Server 26.04 で確認済み。VZ 専用です。

later将来

Signed releases署名済みのリリース

Developer ID signing, notarization and auto-update — once enough people use HanaLima. Until then, one command builds it and installs it into /Applications.Developer ID の署名、公証、自動アップデート。使う人が増えたら取り組みます。それまでは、コマンド 1 つでビルドして /Applications に入れられます。

// quick start

From zero to a VM on your LANゼロから、LAN に参加する VM まで

No signed release yet — build from source. You need macOS 26+, Xcode 26+ with the Metal Toolchain, and Homebrew.署名済みのリリースはまだありません。ソースからビルドしてください。必要なものは macOS 26 以降、Metal Toolchain 入りの Xcode 26 以降、Homebrew です。

  1. Install LimaLima を入れる

    Plus the extra guest agents for non-native architectures.別アーキテクチャ用の追加ゲストエージェントも一緒に。

  2. Build the appアプリをビルド

    The script builds a release, signs the network helper with the virtualization entitlement, signs the app ad hoc for your Mac, installs it into /Applications and opens it. Run it again to update.スクリプトがリリースビルドを作り、ネットワークのヘルパーに仮想化の entitlement を付けて署名し、アプリをこの Mac 用に ad-hoc 署名して、/Applications に入れて起動します。更新するときも同じコマンドです。

  3. Create a VMVM を作る

    ＋ New VM in the sidebar → pick a template (e.g. Ubuntu 24.04 LTS) → Create. The first start downloads the image.サイドバーの ＋ 新規仮想マシン → テンプレート（例: Ubuntu 24.04 LTS）を選んで作成。最初の起動でイメージをダウンロードします。

  4. Add a bridged networkブリッジのネットワークを追加

    Networks → ＋ → Bridge → en0. Then Add NIC in the VM's Settings tab. No password prompt.ネットワーク → ＋ → ブリッジ → en0。VM の設定タブの「NIC を追加」で選びます。パスワードは聞かれません。

# 1. Lima
brew install lima lima-additional-guestagents

# Metal Toolchain (needed by SwiftTerm), once
xcodebuild -downloadComponent MetalToolchain

# 2. HanaLima
git clone https://github.com/izawa/HanaLima.git
cd HanaLima
scripts/make-app.sh --install --open
// roadmap

Where it's goingこれから

This page grows with the app. Each milestone lands here when it ships.このページはアプリと一緒に育ちます。マイルストーンを達成するたびに、ここに反映します。

MVP

  • List, create, start/stop一覧、作成、起動・停止
  • Console, YAML viewコンソール、YAML 表示

v0.2

  • Settings editor, disks設定編集、ディスク
  • Shares, port forwards共有フォルダ、ポート転送
  • Menu bar, start at loginメニューバー、自動起動

v0.3

  • Rootless NAT / host-onlyroot 不要の NAT／ホストオンリー
  • Fixed IPs固定 IP
  • Rootless bridgeroot 不要のブリッジ

v0.4

  • Snapshots (QEMU)スナップショット（QEMU）
  • Screen thumbnails画面のサムネイル
  • Log viewer, provisioningログビューア、プロビジョニング
  • English UI英語 UI

v0.5

  • Snapshots for VZVZ のスナップショット
  • Copies with lineage系譜つきの複製
  • Disks on external drivesディスクを外付けに
  • Home sharing optionalホームを共有しない選択

v0.6

  • Create from an installer ISOインストーラーの ISO から作成
  • Provisioning examplesプロビジョニングの例

Release · later配布 · 将来

  • Developer ID + notarizationDeveloper ID と公証
  • Auto-update自動アップデート
  • Bundled limactllimactl の同梱
// the name

Hana lima — handmadeHana lima ── 手作り

In Hawaiian, hana means to make and lima means hand — and also five. The icon is a plumeria, Hawaii's five-petaled lei flower (and hana sounds like 花, "flower", in Japanese). Each petal is a VM, with vents and a status LED, built by hand around a glowing network core with a >_ prompt. ハワイ語で hana は「作る」、lima は「手」、そして「5」。アイコンは、ハワイのレイに使われる 5 弁の花・プルメリアです（hana は日本語の「花」とも響きます）。花びらの一枚一枚が、通気口と LED を持つ VM。>_ の光るネットワークの芯のまわりに、手で組み上げていきます。

Unofficial project. HanaLima is an independent project. It is not affiliated with, endorsed by, or supported by the Lima project or the Cloud Native Computing Foundation (CNCF). "Lima" is used only to describe what this app works with. Please report HanaLima issues on its own tracker. 非公式プロジェクトです。 HanaLima は個人による独立したプロジェクトで、Lima プロジェクトおよび Cloud Native Computing Foundation (CNCF) とは関係がなく、公認も支援も受けていません。「Lima」の名前は、このアプリが扱う対象を説明するためだけに使っています。HanaLima の問題はこちらの Issue に報告してください。