How to solve: Stage directory is a subdirectory

Created on 21 April 2025, about 11 hours ago

Problem/Motivation

Drupal CMS/D11.1.6 gives me a status report error:

Update readiness checks
Your site does not pass some readiness checks for automatic updates. It cannot be automatically updated until further action is performed.

    Stage directory is a subdirectory of the active directory.

I cannot find any information on the required folder structure.
Also I don't know what "active directory" means or where a stage directory should be located...
Pls. help with some information.

Steps to reproduce

Proposed resolution

Remaining tasks

User interface changes

Introduced terminology

API changes

Data model changes

Release notes snippet

πŸ’¬ Support request
Status

Active

Version

11.1 πŸ”₯

Component

package_manager.module

Created by

πŸ‡¦πŸ‡ΉAustria maxilein

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

  • Issue created by @maxilein
  • Does that Drupal instance have as its configured temporary directory something adjacent to or below the directory containing composer.json?

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    In Package Manager terminology, the "active directory" is the root of the Drupal project: basically, wherever the main project-level composer.json is.

    The "stage directory" (which we are going to rename "sandbox directory" for clarity) needs to be in a temporary directory that is outside the Drupal project. Usually Package Manager will try to compute it by asking the system where the overall temporary directory is (for example, /tmp on most Linux systems), so if the temporary directory is, for some reason, a subdirectory of the Drupal project, you'd get this error.

  • πŸ‡¦πŸ‡ΉAustria maxilein

    Thank you. For the example below I added /active_directory in the structure.

    /../active_directory/composer.json

    /../active_directory/web/ (= Drupal) index.php

    /../active_directory/web/vendor
    /../active_directory/web/tmp
    /../active_directory/web/recipes
    /../active_directory/web/private

    wasn't this the recommended structure until Drupal 9 or 10?

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    /../active_directory/composer.json

    /../active_directory/web/tmp

    This is probably the core of the problem. The temp directory needs to NOT be inside the active directory. In other words, something like this would work better, if you can configure your set-up accordingly:

    ../active_directory/composer.json

    /tmp

  • πŸ‡³πŸ‡ΏNew Zealand quietone
Production build 0.71.5 2024