Why am I seeing "Base directory was not found in your repo" error in Strapi Cloud?

Last updated: September 11, 2025

Context

When deploying or managing a Strapi Cloud project, you may encounter an error message stating "Base directory was not found in your repo" even though the directory exists in your repository. This error prevents you from triggering new deployments and making updates to your application.

Answer

If you encounter the "Base directory was not found in your repo" error, follow these steps to resolve the issue:

  1. Log in to Strapi Cloud using the project owner account (Note: Only the project owner has the necessary permissions to modify these settings)

  2. Navigate to your project settings

  3. Go to the "General" tab

  4. Scroll down to the "Connected repository" section

  5. Click "Update repository"

  6. Verify that the base directory path matches the actual location of your Strapi application in your repository

  7. Toggle the auto-deploy setting (switch it to the opposite state and back)

  8. Save your changes

After following these steps, you should be able to trigger deployments again. If the issue persists, ensure that:

  • The repository is not empty

  • You have proper contribution permissions for the repository

  • The specified branch exists and contains your Strapi application

Important: Only the project owner account can modify repository settings in Strapi Cloud. If you are a contributor, you will need to contact the project owner to make these changes.