Skip to main content

​
Nginx

​
HTTP 403: Forbidden after installing a site

If you receive a HTTP 403: Forbidden response after installing a site, this typically indicates that there is no index.php or index.html file present in the web directory. Nginx is configured to not display directory listings by default for security reasons. Forge no longer deploys sites with a default index.html file. To resolve this issue, you should:
  1. Deploy your application code to the site.
  2. Ensure your application has an index.php file in the web directory (typically /public for Laravel applications).
  3. Verify that your site’s web directory is correctly configured in the site settings.
If you have deployed your application and still see this error, verify that:
  • Your deployment script completed successfully.
  • The web directory path matches where your application’s entry point is located.
  • File permissions are correct (Forge sets these automatically during deployment).

​
Site is stuck deploying

Rarely, your application may get stuck in a “deploying” state. When this occurs, you can reset the deployment state at the top right of the site management panel using the Self Help drop-down menu.

​
Using user isolation with existing sites

It is not currently possible to use isolated users to manage existing sites that have already been created without user isolation. Instead, you will need to create a new site with the user isolation option enabled.

​
Uncommitted commits during deployment

This error may occur when files under source control within the site directory have been changed by the application and will be overwritten by the fresh deployment. You may discard these changes by accessing the Self Help drop-down menu at the top right of the site management panel and triggering the Reset Git State action. Please note that the changes made will be lost when this action is run. You should also review your application and correct any parts of the applications that may be writing to a source controlled directory on your server. Otherwise, you may continue to encounter this error on further deployments.

​
Adding credentials before installing a repository

Laravel Forge does not allow you to install credentials before you have installed a repository; instead, it will redirect you back to the “App” tab. This is because Forge recreates the site’s base directory if the initial installation does not finish successfully. So, if you need to provide local Composer credentials, you first need to install a repository without the “Install Composer Dependencies” checked so that you can update the credentials after the repository is installed.