Troubleshooting Deployments

Deploying a website with Forge is typically a straightforward process, but sometimes you may run into issues. Here are some common problems and their solutions.

Site Deployed Successfully, But Not Visible in Preview

If you're a Windows user and can't see your site in the preview after a successful deployment, it might be due to how Windows archiving tools handle the creation of ZIP files differently from those on macOS.

To resolve this:

  1. Instead of compressing the parent folder of your project into a ZIP file, select all of the contents within the folder and compress them.
  2. Re-upload your archive to Forge.

The issue is usually that Windows-created ZIP files nest the project files too deeply for Forge to recognize your index.html page. This solution fixes that problem.

Missing index.html File

You might want to name your website's main page home.html or something similar, but Forge requires an index.html file in the root of your project folder for successful deployment. You can name other pages as creatively as you like, but ensure you pay attention to precise naming and referencing, especially case sensitivity.

The Forge Console will typically warn you if it can't find an index.html file in your project.

Using .htm Files

While Forge can handle .htm files, your project still needs to have an index.html file in the root of your project for proper deployment.

Stuck or Failed Deployment

The Forge service performs a lot of tasks behind the scenes to prepare your site for deployment, and occasionally, a deployment may fail to complete.

Often, the best solution is to attempt the deployment again in the same manner. Starting a new deployment will override any stuck or in-progress deployments.

If you continue to encounter errors, consult the Forge Deployment Console and examine its messages for clues about the issue.

Unsupported Compressed File Formats

Forge supports only the .ZIP file format for uploads. If you're trying to upload a .RAR or other compressed file format, it won't be recognized. Please ensure you are uploading your project as a .ZIP file.

Remember, if the troubleshooting steps above don't resolve your issue, don't hesitate to reach out to Forge support for further assistance.