Applicable to:
- Plesk for Linux
- Plesk for Windows
Question
How to change or reorder default index files (DirectoryIndex) for all websites on the server?
Answer
For Linux
Note: In the following example, index.php is set as a priority.
-
Log into the server via SSH.
-
For existing domains, use the following command:
# for i in $(plesk bin site -l); do echo "Processing $i"; plesk bin subscription --update-web-server-settings $i -apache-directory-index "index.php index.html index.cgi index.pl index.xhtml index.htm index.shtml"; done
-
For a new domains, create an event handler under Tools & Settings > Event Manager:
-
Log into the server via SSH.
-
Download and unpack script with the same command adjusted event handler usage:
# wget https://support.plesk.com/hc/en-us/article_attachments/360021409174/DefaultDoc.zip
# unzip DefaultDoc.zip
# chmod +x DefaultDoc.sh
# cp -a DefaultDoc.sh /root/DefaultDoc.sh -
Click Add Event Handler and select Physical hosting created event.
-
Under Priority, set the handler execution priority by selecting it from the list or typing in custom number in the field.
-
Select the system user from the User list to execute the handler (in this case, it can be root user).
-
Type the path to the shell script from the step 1 (for example,
/root/DefaultDoc.sh). -
Click OK.
-
For Windows
Note: In the following example test.php file is set as a priority:
-
Connect to the server via RDP.
-
Open PowerShell command line
-
Run one of the following commands depending on the requirements:
-
Set up the "test.php" file as a default document file for all existing domains:
Note: change the "test.php" file in the command below to the correct one.
PS > plesk bin site -l | % { if ( $_ ) { &$env:windir\system32\inetsrv\appcmd.exe set config $_ /section:defaultDocument /enabled:true /+files.[value=`'test.php`'] } }
-
If the following error appears:
CONFIG_TEXT: ERROR ( message:New add object missing required attributes. Cannot add duplicate collection entry of type 'add' with unique key attribute 'value' set to 'main.php'. )
then such file is already present in the default documents list. Modify file priority manually in IIS > hostname > Sites > example.com > Default Documents.
-
Reset the customization of Default Documents to default for all domains:
PS > plesk bin site -l | % { if ( $_ ) { &$env:windir\system32\inetsrv\appcmd.exe clear config $_ /section:defaultDocument } }
-
Additional Information
Reference for Command-Line Utilities, Plesk for Linux. subscription: Subscriptions
Administrator's Guide. Event Handlers
Administrator's Guide. Event Handlers. Physical hosting created
Comments
6 comments
This is really helpful. I'd like to make some suggestions please:
For item 3, users who are not familiar with Event Handler may wonder which priority to use. Maybe it could be suggested that the default priority should be used.
For item 4, again new users may be confused. I would assume only the root user would have the correct permissions to run the "subscription" command. But if there is a better user to select, maybe you could add an appropriate suggestion?
@Faris Hi!
Thank you for the feedback.
> For item 3, users who are not familiar with Event Handler may wonder which priority to use. Maybe it could be suggested that the default priority should be used.
Its hard to say for sure, how many handlers already exist and recommending to set the default (lowest) priority can lead to incorrect behavior.
> For item 4, again new users may be confused. I would assume only the root user would have the correct permissions to run the "subscription" command
I have updated the article according your recommendation. Thanks again :)
How do you do this for windows plesk?
@Steven A solution for Windows was added
@Albert Stienen
What exact error do you see?
Please note that Powershell should be used and not the default Command Prompt.
Hello @Albert,
Thank you for paying our attention.
The article was reworked.
According to IIS documentation, there is no way to change the priority of existing file via command line. If it is necessary to change the priority of such a file, it should be configured manually in IIS > hostname > Sites > example.com > Default Documents.
A new file can be added to the top of the list using the following script:
plesk bin site -l | % { if ( $ ) { &$env:windir\system32\inetsrv\appcmd.exe set config $ /section:defaultDocument /enabled:true /+files.[value=`'test.php`'] } }
Please sign in to leave a comment.