Skip to main content
Version: Next

Moving the data directory

A guide for safely and reliably managing Executor’s persistent data.

Executor stores all persistent data — including metadata, assets, internal files, execution result — under the following directory:

/var/lib/executor

This document explains how to safely move the Executor data directory.

Changing the Executor data directory​

If you prefer to store Executor’s persistent files on an external disk or larger storage volume, you can safely migrate the data directory using the provided migration script.

Executor includes a script that handles the migration process automatically.

Run:

sudo sh /opt/executor/api/scripts/migrate-data-dir.sh <new_full_data_directory_path>

The script will:

  • Stop Executor services
  • Copy the existing data to the new storage location
  • Update system configuration
  • Restart Executor services
Important
  • Do not manually move or delete the /var/lib/executor directory.
  • Always use the provided script to avoid permission issues or data loss.