Guest customization Settings to customize a Linux guest operating system. The LinuxConfiguration structure contains settings that identify a Linux machine in the same way that the WindowsConfiguration structure identifies a Windows machine.

JSON Example
    "hostname": {
        "type": "string",
        "fixed_name": "string",
        "prefix": "string"
    "domain": "string",
    "time_zone": "string",
    "script_text": "string",
    "compatible_customization_method": "string"

The HostnameGenerator structure specifies various mechanisms of generating the hostname for the guest inside the virtual machine while customization.


The fully qualified domain name.


The case-sensitive time zone, such as Europe/Sofia. Valid time zone values are based on the tz (time zone) database used by Linux. The values are strings (string) in the form "Area/Location," in which Area is a continent or ocean name, and Location is the city, island, or other regional designation. See the for a list of supported time zones for different versions in Linux.

If unset, time zone is not modified inside guest operating system.


The script to run before and after Linux guest customization. The max size of the script is 65536 bytes. As long as the script (shell, perl, python...) has the right "#!" in the header, it is supported. The caller should not assume any environment variables when the script is run. The script is invoked by the customization engine using the command line: 1) with argument "precustomization" before customization, 2) with argument "postcustomization" after customization. The script should parse this argument and implement pre-customization or post-customization task code details in the corresponding block.

A Linux shell script example:

#!/bin/sh if [ x$1 == x"precustomization" ]; then echo "Do Precustomization tasks" #code for pre-customization actions... elif [ x$1 == x"postcustomization" ]; then echo "Do Postcustomization tasks" #code for post-customization actions... fi

If unset, no script will be executed.


The compatible customization method is an identifier of a customization strategy which is implementable in a group of Linux operating systems. This value does not need to be set if your operating system is officially supported by VMware guest operating system customization. When using a Linux operating system which hasn't been officially supported and it is designed to be 100% bug-for-bug compatible with an officially supported Linux operating system, it can be customized by an existing customization method. Please set the compatible customization method to a supported string value e.g. "GOSC_METHOD_1". See all the supported compatible customization methods in

If unset, the customization may fail in a Linux operating systems which hasn't been officially supported.