Configuration reference#
Top-level fields#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Contract version, independent of the installed Limanix package version. |
|
|
|
Sandbox name. |
user#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Regular guest username. |
|
|
|
Guest user's home directory. |
|
|
|
Passwordless sudo inside the guest. |
resources#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Guest architecture. |
|
|
|
Guest system disk size in GiB. |
|
|
|
Guest memory size in GiB. |
|
|
|
Guest CPU count, a positive integer. |
home#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Host root for <root>/<name>-<id>. Limanix creates this directory on the Mac and mounts it at user.home with read-write access. |
nixos#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Selected modules: lmx:NAME or lmx:NAME-VERSION from the embedded catalog, or third-party:NAME imported with limanix modules add. Omitting a version selects the module default. Multiple versions and repeated identifiers are accepted; an empty list installs no optional modules. |
network#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Shared/NAT network. The Mac reaches the guest by its own IP address. |
network.ports#
Field |
Type |
Default |
Description |
|---|---|---|---|
|
|
|
Inbound TCP ports in the guest firewall. Services listen on a guest network interface and are reached at <guest-ip>:<port> from the Mac. |
|
|
|
Inbound UDP ports in the guest firewall. |
env#
Guest-wide environment for login sessions and system/user services.
Type: table[string, string].
Default key |
Default value |
|---|---|
|
|
|
|
mounts#
Host directories mounted inside the guest.
Field |
Type |
Default per entry |
Description |
|---|---|---|---|
|
|
|
Mount access: rw or ro. |
|
|
Required |
Host directory to mount inside the guest. |
|
|
Required |
Mount destination inside the guest. |
Default entries#
|
|
|
|---|---|---|
|
|
|
|
|
|