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/guestaddons/create_update_disk.sh                |
+-----------------------------+-------------------------------------------------------------------------------------------+
| addons_identifier           | ANKA_ADDONS_IDENTIFIER                                                                    |
+-----------------------------+-------------------------------------------------------------------------------------------+
| addons_image                | /Library/Application Support/Veertu/Anka/guestaddons/anka-addons-mac                      |
+-----------------------------+-------------------------------------------------------------------------------------------+
| addons_pkg                  | com.veertu.anka.guestaddons.pkg                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| addons_postupdate           | /Library/Application Support/Veertu/Anka/guestaddons/postupdate.sh                        |
+-----------------------------+-------------------------------------------------------------------------------------------+
| allow_nonunique_names       | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| anka_executable             | /Library/Application Support/Veertu/Anka/bin/ankahv-arm64.app/Contents/MacOS/ankahv-arm64 |
+-----------------------------+-------------------------------------------------------------------------------------------+
| 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           |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| bios_path                   |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| block_nocache               | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| bridge_name                 |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| ca_bundle                   | /Users/nathanpierce/.anka/ca-bundle.crt                                                   |
+-----------------------------+-------------------------------------------------------------------------------------------+
| catalog_url                 | https://mesu.apple.com/assets/macos/com_apple_macOSIPSW/com_apple_macOSIPSW.xml           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| chunk_size                  | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| click_executable            | /Library/Application Support/Veertu/Anka/bin/click                                        |
+-----------------------------+-------------------------------------------------------------------------------------------+
| create_suspend              | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_disk                | 137438953472                                                                              |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_format              | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_nvcpu               | 4                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_passwd              | admin                                                                                     |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_ram                 | 4294967296                                                                                |
+-----------------------------+-------------------------------------------------------------------------------------------+
| default_user                | anka                                                                                      |
+-----------------------------+-------------------------------------------------------------------------------------------+
| delete_logs                 | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| end_address                 |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| exit_delay                  | 10                                                                                        |
+-----------------------------+-------------------------------------------------------------------------------------------+
| fvutil_executable           |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| img_lib_dir                 | /Users/nathanpierce/Library/Application Support/Veertu/Anka/img_lib                       |
+-----------------------------+-------------------------------------------------------------------------------------------+
| img_path                    |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| implicit_mount              | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| install_tool                | /Library/Application Support/Veertu/Anka/bin/ankahv-arm64.app/Contents/MacOS/ankahv-arm64 |
+-----------------------------+-------------------------------------------------------------------------------------------+
| io_threads                  | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| log_dir                     | /Users/nathanpierce/Library/Logs/Anka/                                                    |
+-----------------------------+-------------------------------------------------------------------------------------------+
| log_file                    | anka.log                                                                                  |
+-----------------------------+-------------------------------------------------------------------------------------------+
| max_vms_allowed             | 255                                                                                       |
+-----------------------------+-------------------------------------------------------------------------------------------+
| network_failure_action      | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| nice                        | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| operations_timeout          | 300                                                                                       |
+-----------------------------+-------------------------------------------------------------------------------------------+
| options_api_url             | https://licensing.veertu.com/prod/key/info                                                |
+-----------------------------+-------------------------------------------------------------------------------------------+
| portfwd_base                | 10000                                                                                     |
+-----------------------------+-------------------------------------------------------------------------------------------+
| process_type                | Interactive                                                                               |
+-----------------------------+-------------------------------------------------------------------------------------------+
| product_root                | /Library/Application Support/Veertu/Anka                                                  |
+-----------------------------+-------------------------------------------------------------------------------------------+
| propagate_license           | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| propagate_name              | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| pull_checkout               | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| pull_failback               | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| pull_resume                 | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| puller_threads              | 4                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| qncpu                       | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| quantum                     | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| qvcpu                       | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| registry_remotes_file_path  | /Users/nathanpierce/.anka/remote                                                          |
+-----------------------------+-------------------------------------------------------------------------------------------+
| shared_nat                  | 0                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| start_address               |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| state_lib_dir               | /Users/nathanpierce/Library/Application Support/Veertu/Anka/img_lib                       |
+-----------------------------+-------------------------------------------------------------------------------------------+
| subnet_mask                 |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| swap_dir                    |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| table_fmt                   | grid                                                                                      |
+-----------------------------+-------------------------------------------------------------------------------------------+
| tag_lib_dir                 |                                                                                           |
+-----------------------------+-------------------------------------------------------------------------------------------+
| tessdata_dir                | /Library/Application Support/Veertu/Anka/tessdata                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| tesslang                    | eng                                                                                       |
+-----------------------------+-------------------------------------------------------------------------------------------+
| time_sync                   | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| trim_disk                   | 1                                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| uhost_executable            | /Library/Application Support/Veertu/Anka/bin/uhost                                        |
+-----------------------------+-------------------------------------------------------------------------------------------+
| vlaunch_sock                | /var/run/vlaunchd                                                                         |
+-----------------------------+-------------------------------------------------------------------------------------------+
| vm_lib_dir                  | /Users/nathanpierce/Library/Application Support/Veertu/Anka/vm_lib                        |
+-----------------------------+-------------------------------------------------------------------------------------------+
| vm_lock_dir                 | /Users/nathanpierce/Library/Application Support/Veertu/Anka/vm_lib/.locks                 |
+-----------------------------+-------------------------------------------------------------------------------------------+
❯ 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/img_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 /Library/Application\ Support/Veertu/Anka/bin/ankahv as well as /Library/Application\ Support/Veertu/Anka/bin/anka_agent. Make sure the slider button is enabled too!