Modifying the Global Configuration

How to modify the Global Anka Virtualization configuration
> anka config --help
usage: config [options] [param...]

   Manage the CLI configuration

arguments:
  param                    Parameter name

options:
  -l,--list                List parameter(s)
  -r,--reset               Reset parameter(s) back to default

Viewing the configuration

View all default configuration settings for Anka installation on the host with anka config command:

❯ anka config
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_disk_tool            | /Library/Application Support/Veertu/Anka/tools/addons_create_update_disk                                                                                             |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_hotupdate            | /Library/Application Support/Veertu/Anka/tools/addons_hotupdate.sh                                                                                                   |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_identifier           | com.veertu.anka.addons.core.pkg                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_image                | /Library/Application Support/Veertu/Anka/guestaddons/anka-addons-mac.iso                                                                                             |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_pkg                  | com.veertu.anka.guestaddons.pkg                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addons_postupdate           | /Library/Application Support/Veertu/Anka/tools/addons_postupdate.sh                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| adresses_per_byte           | 250                                                                                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| allow_nonunique_names       | False                                                                                                                                                                |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| anka_executable             | /Library/Application Support/Veertu/Anka/bin/ankahv                                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| anka_image_maker_executable | /Library/Application Support/Veertu/Anka/bin/anka_image                                                                                                              |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| anka_viewer                 | /Applications/Anka.app                                                                                                                                               |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ankactl_executable          | /Library/Application Support/Veertu/Anka/bin/ankactl                                                                                                                 |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ankanet_sock                | /var/run/ankanetd                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ankasc_executable           | /Library/Application Support/Veertu/Anka/bin/ankasc                                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| bios_path                   | /Library/Application Support/Veertu/Anka/uefi/anka_code.fd                                                                                                           |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| block_nocache               | 1                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| bridge_name                 |                                                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ca_bundle                   | /Users/user1/.anka/ca-bundle.crt                                                                                                                              |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| catalog_url                 | https://swscan.apple.com/content/catalogs/others/index-13-12-10.16-10.15-10.14-10.13-10.12-10.11-10.10-10.9-mountainlion-lion-snowleopard-leopard.merged-1.sucatalog |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| chunk_size                  | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| create_suspend              | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_disk                | 137438953472                                                                                                                                                         |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_format              | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_nvcpu               | 4                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_passwd              | admin                                                                                                                                                                |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_ram                 | 4294967296                                                                                                                                                           |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| default_user                | anka                                                                                                                                                                 |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| delete_logs                 | 1                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| exit_delay                  | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| fvutil_executable           | /Library/Application Support/Veertu/Anka/bin/fvutil                                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| img_lib_dir                 | /Users/user1/Library/Application Support/Veertu/Anka/img_lib/                                                                                                 |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| img_path                    |                                                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| implicit_mount              | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| install_tool                | /Library/Application Support/Veertu/Anka/tools/install_macos                                                                                                         |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| io_threads                  | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| log_dir                     | /Users/user1/Library/Logs/Anka/                                                                                                                               |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| log_file                    | anka.log                                                                                                                                                             |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| mac_random_bytes            | 2                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| max_vms_allowed             | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| mitigations                 | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| nice                        | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| nvram_path                  | /Library/Application Support/Veertu/Anka/uefi/anka_vars.fd                                                                                                           |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| operations_timeout          | 300                                                                                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| options_api_url             | https://8ewgf8mtn4.execute-api.us-west-2.amazonaws.com/prod/key/info                                                                                                 |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| permanent_mac_prefix        | 86,69,69                                                                                                                                                             |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| portfwd_base                | 10000                                                                                                                                                                |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| process_type                | Interactive                                                                                                                                                          |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| product_root                | /Library/Application Support/Veertu/Anka                                                                                                                             |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| propagate_license           | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| propagate_name              | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| pull_checkout               | 1                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| puller_threads              | 4                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| qncpu                       | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| quantum                     | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| qvcpu                       | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| registry_remotes_file_path  | /Users/user1/.anka/remote                                                                                                                                     |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| state_lib_dir               | /Users/user1/Library/Application Support/Veertu/Anka/state_lib/                                                                                               |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| table_fmt                   | grid                                                                                                                                                                 |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| tag_lib_dir                 |                                                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| time_sync                   | 1                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| trim_disk                   | 1                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| uhost_executable            | /Library/Application Support/Veertu/Anka/bin/uhost                                                                                                                   |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| version_compat              | 0                                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| vlaunch_sock                | /var/run/vlaunchd                                                                                                                                                    |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| vm_lib_dir                  | /Users/user1/Library/Application Support/Veertu/Anka/vm_lib/                                                                                                  |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| vm_lock_dir                 | /Users/user1/.anka/locks                                                                                                                                      |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| vnc_password                | admin                                                                                                                                                                |
+-----------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+
❯ anka config puller_threads
4

❯ anka config puller_threads 10

❯ anka config puller_threads
10

You can see a value for a specific configuration parameter with anka config $PARAM_NAME.

  • The default VM username is anka
  • The default VM password is admin
  • The default storage locations for Anka VM Templates & Tags are:
    • vm_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/vm_lib/
    • state_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/state_lib/
    • img_lib_dir - /Users/XXX/Library/Application Support/Veertu/Anka/img_lib/
  • The log directory is /Users/XXX/Library/Logs/Anka/ and log file is anka.log.

Changing the default Anka VM storage location

Depending on how many Anka VMs you have, the disk usage might be too much for the default storage location. There are three configuration parameters to control location for storing Anka VMs.

Anka 3.x and greater requires a APFS volume.
It’s recommended to keep the vm_lib_dir on the local disk as it contains file locks.

Assuming you want to store your Templates on /Volumes/ExternalDrive/, perform these steps:

  1. anka config img_lib_dir /Volumes/ExternalDrive/image_lib
  2. anka config state_lib_dir /Volumes/ExternalDrive/state_lib
  3. anka config vm_lib_dir /Volumes/ExternalDrive/vm_lib
  4. Go under System Preferences > Security & Privacy > Full Disk Access and add ankahv. Make sure the slider button is enabled too!