init_conf: Server Configuration

The init_conf utility is used to perform the initial configuration of Plesk through CLI. By using this utility, you can also edit certain parameters configured during the initial configuration of the Plesk server. By using this utility, you can perform the following tasks:

  • setting host name for the Plesk server
  • setting the default IP address for the Plesk server
  • configuring Plesk server networking parameters
  • adding IP addresses to the list of shared IP addresses
  • specifying and editing Plesk administrator's personal information
  • creating the default client account for the Plesk administrator

Usage
init_conf <command> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
]

Example

The following command sets the default IP address to 192.0.2.14 and sets its type to shared; sets the network mask to 255.255.255.0 and the network interface name to eth0 for the default IP address; adds shared IP addresses 192.0.2.46 and 192.0.2.47 to Plesk ; sets the Plesk administrator’s name to John Doe and the administrator’s password to adminpass; sets the administrator's phone number to 555-5555, fax number to 333-3333, and email address to admin@example.com; sets the administrator's company name to Megacompany Inc., street address to 45 Trail street, city to New York, ZIP code to 10292, and country to United States.

plesk bin init_conf --init -default-ip 192.0.2.14 -netmask 255.255.255.0 -iface eth0 -ip-type shared -hostname example.com -shared_ips add:192.0.2.46,192.0.2.47 -name "John Doe" -passwd mypass -phone 555-5555 -fax 333-3333 -email admin@example.com -company "Megacompany Inc." -address "45 Trail street" -city "New York" -zip 10292 -country US -state NY

Commands
Command Parameter Description Example

--init

 

Initializes a non-configured Plesk server.

Requires following options: -name, -passwd, -phone, -company, -email, -address, -city, -country, -state, -pcode.

 

Note: The -state option is required only if the -country option value is US.

To set the Plesk default IP address to 192.0.2.14, make the address shared, set the network mask to 255.255.0.0, network interface name to eth0, and specify the Plesk administrator's personal information:

plesk bin init_conf --init -default-ip 192.0.2.14 -netmask 255.255.0.0 -iface eth0 -ip-type shared -name "John Doe" -passwd mypass -phone 555-4444 -fax 555-4433 -email admin@example.com -address "45 Trail street" -city "New York" -country US -state NY -zip 10292

--update or -u

 

Updates the Plesk Panel administrator’s personal information.

To set the Plesk administrator's email address to admin@example.com:

plesk bin init_conf --update -email admin@example.com

or

plesk bin init_conf -u -email admin@example.com

--check-configured or -c

 

Checks whether Plesk is configured. Returns 0 on success, 1 otherwise.

To check if Plesk is configured:

plesk bin init_conf --check-configured

or

plesk bin init_conf -c

--set-admin-password or -p

 

Changes the Plesk administrator’s password on an already initialized Plesk .

Sets administrator's password on a non-initialized Plesk without initialization.

To set the Plesk administrator's password to mypassword:

plesk bin init_conf --set-admin-password -passwd mypassword

or

plesk bin init_conf -p -passwd mypassword

--help or -h

 

Displays help on the use of the utility.

To view help on the use of the init_conf utility:

plesk bin init_conf --help

or

plesk bin init_conf -h

Options
Option Parameter Description Example

-company

<string>

Specifies the Plesk administrator's company name.

Required with the --init.

To set the Plesk administrator's company name to Megacompany:

plesk bin init_conf -u -company Megacompany

-name

<string>

Specifies the Plesk administrator’s contact name.

Required with the --init.

To set the Plesk administrator's contact name to John Doe:

plesk bin init_conf -u -name "John Doe"

-passwd

<password>

Specifies the Plesk administrator’s password for access to Plesk Panel.

Required with the --init and with the --set-admin-password.

To set the Plesk administrator's password to sample:

plesk bin init_conf -u -passwd sample

-phone

<number>

Specifies the Plesk administrator's phone number.

Required with the --init.

To set the Plesk administrator's phone number to 323-4455:

plesk bin init_conf -u -phone 323-4455

-fax

<number>

Specifies the Plesk administrator's fax number.

To set the Plesk administrator's fax number to 323-4433:

plesk bin init_conf -u -fax 323-4433

-email

<string>

Specifies the Plesk administrator's email address.

Required with the --init.

To set the Plesk administrator's email address to admin@example.com:

plesk bin init_conf -u -email admin@example.com

-address

<string>

Specifies the Plesk administrator’s street address.

Required with the --init.

To set the Plesk administrator's street address to 45 Trail street:

plesk bin init_conf -u -address "45 Trial Street"

-city

<string>

Specifies the Plesk administrator’s city.

Required with the --init.

To set the Plesk administrator's city to New York:

plesk bin init_conf -u -city "New York"

-state

<string>

Specifies the Plesk Panel administrator’s state/province.

Required with the --init.

To set the Plesk Panel administrator's state to NY:

plesk bin init_conf -u -state NY

-zip

<string>

Specifies the Plesk administrator’s postal/zip code.

Required with the --init.

To set the Plesk administrator's zip code to 10292:

plesk bin init_conf -u -zip 10292

-country

<string>

Specifies the Plesk administrator’s country.

The parameter of the command must be a valid two-letter country code as described in ISO-3166 (for example, "AU" stands for Australia).

Required with the --init.

To set the Plesk administrator's country to United States:

plesk bin init_conf -u -country US

-hostname

<domain_name>

Specifies the Plesk server's host name.

Used with the --init only.

To set the server's host name to host.example.com:

plesk bin init_conf --init -hostname host.example.com -name <..> -passwd <..> -phone <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

-shared_ips

add:<ip_1>,<ip_2>, ...,<ip_n>

Sets the IP addresses specified by the parameters as shared.

The IP addresses must be added to the server IP address pool before they can be assigned the shared status.

Used with the --init only.

To set IP addresses 192.0.2.46 and 192.0.2.47 as shared IP addresses:

plesk bin init_conf --init -shared_ips add:192.168.123.46,192.168.123.47 -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

-send_tech_announce

true|false

Allows/Prohibits sending to the administrator email security-related information and other technical notifications from Plesk.

To subscribe the administrator to security-related information and other technical notifications from Plesk :

plesk bin init_conf -u -send_tech_announce true

-send_announce

true|false

Allows/Prohibits sending to the Plesk administrator email notifications on new products and promotions from Plesk.

To subscribe the Plesk administrator to Plesk notifications about new products and promotions lists of Plesk:

plesk bin init_conf -u -send_announce true

-def_client

 

Creates the default client account MyDomains for the Plesk administrator.

Deprecated.

To create the default client account for the Plesk administrator:

plesk bin init_conf --init -def_client -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -state <..> -zip <..>

-default-ip

<IP_address>

Specifies the default IP address during initial Plesk configuration.

This option is used with the --init only.

If this address has not yet been added to the server IP address pool, the option requires use of the -netmask, -iface, and -ip-type options.

To set the Plesk default IP address to 192.0.2.14, make the address shared, set the network mask to 255.255.0.0, and network interface name to eth0:

plesk bin init_conf --init -default-ip 192.0.2.14 -netmask 255.255.0.0 -iface eth0 -ip-type shared -name <..> -passwd <..> -phone <..> -fax <..> -email <..> -addr <..> -city <..> -country <..> -state <..> -zip <..>

 

-netmask

<IPaddress|nn>

Specifies a network mask for the default IP address in Plesk during initial Plesk configuration.

Used with the --init only.

-iface

<dev>

Specifies a name for the network interface for the default IP address during initial Plesk configuration.

Used with the --init only.

-ip-type

shared|exclusive

Specifies the type of the default IP address during initial Plesk configuration.

Used with the --init only.

-encrypted-password

 

Forces Plesk to store the Plesk administrator's password in the encrypted form.

To force Plesk to store the Plesk administrator's password in the encrypted form:

plesk bin init_conf -u -encrypted-password

-plain-password

 

Forces Plesk to store the Plesk administrator's password in plain text.

To force Plesk to store the Plesk administrator's password in plain text:

plesk bin init_conf -u -plain-password

-admin_info_not_required

true|false

Defines whether Plesk administrator's personal info (except for email) is marked as Required or not.

Is false by default.

To initialize Plesk server so that the Plesk administrator after entering his credentials to freshly-installed Plesk got directly to administrator's desktop skipping all 'first-login configuration' screens:

plesk bin init_conf -u -admin_info_not_required true

-license_agreed

true|false

Defines whether the Plesk license agreement is accepted.

Is false by default.

To initialize Plesk server so that the Plesk administrator after entering his credentials to freshly-installed Plesk automatically agrees with the license agreement:

plesk bin init_conf -u -license_agreed true