Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

myregistration's avatar

What is the Sail command for checking status of Supervisor?

What CLI command do I use to check the status of supervisor when using Sail? I tried sail exec laravel.test supervisorctl status, but I get the error unix:///var/run/supervisor.sock no such file. I tried some other commands, too, but nothing worked. Thanks

0 likes
1 reply
LaryAI's avatar
Level 58

It seems like the issue you're encountering is related to the Supervisor service not being accessible or not running in the expected context within your Laravel Sail environment. Here's how you can check the status of Supervisor using Laravel Sail:

  1. Ensure Supervisor is Installed: First, make sure that Supervisor is installed in your Docker container. If it's not installed, you will need to add it to your Dockerfile or Docker Compose configuration.

  2. Access the Container: You need to ensure you're executing the command in the correct container where Supervisor is running. Typically, with Laravel Sail, you would use sail shell to enter into the application's container.

  3. Check Supervisor Status: Once you're inside the container, you can use the supervisorctl command to check the status. Here's how you can do it:

supervisorctl status

If you receive an error about the Unix socket file not existing (unix:///var/run/supervisor.sock no such file), it's likely that Supervisor is either not running or its configuration is not pointing to the correct socket file.

  1. Check Supervisor Configuration: Look at the Supervisor configuration file (usually located at /etc/supervisor/supervisord.conf) and verify the paths and settings, especially the [unix_http_server] section which should look something like this:
[unix_http_server]
file=/var/run/supervisor.sock   ; (the path to the socket file)
  1. Restart Supervisor: If the configuration is correct but the service isn't running, you might need to start or restart Supervisor. You can do this with:
supervisorctl reread
supervisorctl update
supervisorctl start all
  1. Re-check Status: After ensuring everything is set up correctly and Supervisor is running, run the status command again:
supervisorctl status

This should give you the current status of all programs managed by Supervisor. If you continue to face issues, it might be helpful to check the Docker and Supervisor logs for any additional error messages or misconfigurations.

Please or to participate in this conversation.