Cannot rename domain

If you encounter difficulties renaming a domain, it is often because PHP was selected as the FPM variant.

Error message:

Unable to rename home of sysuser [..] User is currently used by process <pid>

Stop Supervisor Processes

Since the supervisor processes also access the domain’s file system path, they must be stopped first so that the domain can be renamed without errors. Run the following command using our system user, whose login credentials you can view in the password vault:

supervisorctl stop all

Stop the PHP-FPM service

Navigate to the website you want to rename and determine the currently active PHP version. In this example, PHP 8.2.11 is active for the website. Then navigate to the menu item Tools & Settings → Service Management.

Stop the PHP-FPM service that is active for the website using the Stop icon. Then navigate to Websites & Domains and open the domain you want to rename.

Click the … button next to the desired domain and select Change Domain Name.

Then enter the desired domain (without www.). In this example, we’re using the domain creoline-demo.com.

Supervisor Processes: Adjust Path and Start Processes

Adjust the domain name in the paths within the Supervisor configuration via our Customer Center.

To do this, follow the instructions in the following Help Center article: Shopware 6 Background Queue Worker (Managed Server)

Then restart the Supervisor processes as follows:

supervisorctl start all

Start the PHP-FPM service

Finally, navigate back to Tools & Settings → Service Management and re-enable the PHP 8.2 FPM service. If the service has already been restarted after the renaming, the renaming process has been successfully completed.