phacility/phabricator · error · PhutilArgumentUsageException

The "--local-disk-source" argument must point to a valid, re

Error message

The "--local-disk-source" argument must point to a valid, readable directory on local disk.

What it means

Error "The "--local-disk-source" argument must point to a valid, readable directory on local disk." thrown in phacility/phabricator.

Source

Thrown at src/applications/files/management/PhabricatorFilesManagementMigrateWorkflow.php:70

      ->setName('migrate')
      ->setSynopsis(pht('Migrate files between storage engines.'))
      ->setArguments($arguments);
  }

  public function execute(PhutilArgumentParser $args) {

    // See T13306. This flag allows you to import files from a backup of
    // local disk storage into some other engine. When the caller provides
    // the flag, we override the local disk engine configuration and treat
    // it as though it is configured to use the specified location.

    $local_disk_source = $args->getArg('local-disk-source');
    if (strlen($local_disk_source)) {
      $path = Filesystem::resolvePath($local_disk_source);
      try {
        Filesystem::assertIsDirectory($path);
      } catch (FilesystemException $ex) {
        throw new PhutilArgumentUsageException(
          pht(
            'The "--local-disk-source" argument must point to a valid, '.
            'readable directory on local disk.'));
      }

      $env = PhabricatorEnv::beginScopedEnv();
      $env->overrideEnvConfig('storage.local-disk.path', $path);
    }

    $target_key = $args->getArg('engine');
    if (!$target_key) {
      throw new PhutilArgumentUsageException(
        pht(
          'Specify an engine to migrate to with `%s`. '.
          'Use `%s` to get a list of engines.',
          '--engine',
          'files engines'));
    }

View on GitHub (pinned to 5720a38cfe)

When it happens

Trigger: Thrown at src/applications/files/management/PhabricatorFilesManagementMigrateWorkflow.php:70 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of phacility/phabricator@5720a38cfe (2026-08-21). Data as JSON: /api/errors/521232c5ce5644cf. Report an issue: GitHub.