--- updatedAt: 2026-10-01T10:06:06.000Z agentTools: siteIndex: https://docs.jfrog.com/llms.txt projectIndex: https://docs.jfrog.com/administration/llms.txt --- # Smart Archiving Archiving transfers data from an active server to a backup system to free up space, enhance performance, and ensure data is available for future retrieval (for example, to audit regulatory compliance). General_Archive_Architecture.png ## Archive in JFrog The [JFrog Smart Archiving](/docs/archive) solution facilitates the seamless transfer of critical but inactive packages from an Active Artifactory instance to a dedicated Archive instance. This architectural separation allows organizations to strictly enforce long-term retention policies for regulatory compliance, while simultaneously protecting the speed and performance of their active CI/CD pipelines. Archive Policies enable Platform and Project Administrators to define customized rules for archiving dormant binaries based on specific criteria across the JFrog platform. This approach offers the following benefits: * **Reduced storage costs**: Enhances system performance and improves loading times within the JFrog Platform. * **Boosted efficiency**: Enhances system performance and improves loading times within the JFrog Platform. * **Enhanced user experience**: Minimizes the number of items to navigate, saving time and improving overall user experience. * **Ensure compliance**: Ensures compliance by archiving artifacts and restoring them when needed. ![](https://files.readme.io/64f0dd8c4b5a12a6a9bd931c1685ccb0565cceb4bbe3a97afa94c2b6a0ed3883-uuid-ebee0563-42af-07a7-896a-7986f44bf836.png) Smart Archiving is a new solution that enhances user experience, features, and infrastructure while addressing current limitations. Upgrade for better performance.
### For more information, see **[Smart Archiving](https://academy.jfrog.com/smart-archiving-optimize-storage-and-ensure-compliance)** at JFrog Academy. ### **Subscription Information** Currently, this feature is supported from 7.111 for the **Multi-Cloud** platform, with an **Enterprise+** subscription. Supported cloud providers are as follows: - AWS - GCP - Azure For a Hybrid Self-hosted Platform, it is supported from 7.117.14. ### Smart Archiving Features This topic outlines smart archiving features. It includes archiving, searching and restoring packages. * **Archive Policy** Archive policies define which packages need to be archived. When the policy is executed, packages are moved from the Active Artifactory Instance to the Archive Artifactory Instance, while the corresponding packages are stored in the Storage connected to the Archive Artifactory Instance. **Scheduled Execution:** Scheduling enables you to configure the periodic execution of a policy that can be set to any frequency defined by a cron schedule. You can also define when (or after what period) the policy execution will be stopped, which enables you to perform archiving execution during weekends or maintenance windows. ### **Note** If required, you can run the archive policy manually. For more information, see the [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually). After packages are successfully archived in the Archive Artifactory Instance, the archived items and corresponding metadata are deleted from the original repository in the Active Artifactory Instance. If the archive process fails, items and the corresponding metadata are not removed, and the incident is logged with an appropriate error message. As the archive process progresses, the system generates detailed logs in the [Artifactory service logs](/administration/docs/log-files-location-and-naming#service-log) in the Active Artifactory Instance. Admins can manage archive policies, such as create, view, edit, and delete, using the UI or APIs. For more information, see [Manage Smart Archiving - Policies](#manage-smart-archiving---policies). ### **Note** Only Platform and Project admins can create and manage archive policies. For more information on authorizations, see [Smart Archiving - User Activities and Authorizations](#smart-archiving---user-activities-and-authorizations). * **Archive Search** Admins can use the search feature to perform dedicated archive searches in the Active Artifactory Instance, allowing them to locate and restore packages as needed. For more information, see [Search Archived Packages](#search-archived-packages). * **Restore Archived Packages** After searching for archived packages, admins can restore them from the Archive Artifactory Instance to the Active Artifactory Instance. ### **Note** Restore action does not delete the packages in the Archive Artifactory Instance. When performing a restore action, the admin can choose one of the following destinations: * Restore items to their original repository and provide a fallback repository (if the original repository was deprecated). * Restore all the items to a new repository. The system performs the restore operation in the background and updates the Artifactory service logs in the Archive Artifactory instance. For more information, see [Restore Archived Packages](#restore-archived-packages). ### **Note** - The restore process may take from a few minutes to several hours, depending on the number of items being restored and the cloud provider. - If an error occurs during the restore, the process will fail, and error messages will be logged. ### Smart Archiving Limitations This topic outlines the limitations of the smart archiving feature. **Supported Repositories** * Supports Local and Federated repositories. Does not support Remote and Virtual repositories. ### **Note** When archiving Federated repositories, the run (dry or actual) can take significantly longer compared to Local repositories. This is because the archive workflow must check the last download status of each package across all federation members. The more members involved, the longer the process will take. **Recommendations to Optimize Archive:** - **Adjust Policy Conditions**: Narrow the scope of your archive policies to reduce the number of packages to be archived in each run. This can significantly speed up the run. - **Increase Run Frequency**: Run archive policies more often to process smaller sets of packages. This helps prevent large backlogs and improves long-term performance. **Push-Replicated Repositories** An archive policy can include a local repository configured for remote push replication. The policy does not exclude these repositories. ### **Warning** Deletions from that repository will be replicated to the remote targets. **Package Verification** There is no verification if packages are part of a Release Bundle or build. A package-level Archive policy may impact build or release bundle promotion. **Archive Limits** An archive policy can archive up to 100,000 packages in a single run. **Progress Notifications** Notifications on the progress of an archive policy run and restore run are unavailable. **Visibility of Run Results** Run results for global policies are visible only to Platform admins globally. **Archive Policy** The Archive policy does not execute when an ongoing mandatory task is in progress (for example, Garbage Collection). **Search** A project admin can only perform searches within their project context and does not have access to the global scope. **Archive Evidence** From Artifactory Version 7.117, added support for the archival of evidence associated with any packages. This enhancement ensures that relevant evidence is preserved as part of your archiving strategy, streamlining your package management process. ### **Note** In Artifactory versions before 7.117, if you archive packages that have associated evidence, the evidence will not be archived. When restoring packages archived in these earlier versions, only the packages themselves will be restored, and any associated evidence will not be restored. **Concurrent Execution and Queuing of Archive Policies** * Archive Policies can run concurrently up to a specified maximum. When this limit is reached, additional triggered policies are queued. Any further triggered policies will be skipped entirely if the queue reaches its maximum capacity. * In the current version of Artifactory, queued or skipped policy runs do not appear in the Runs view. You can find a log of skipped policies in the Artifactory Service log. For example, you might see a message like: `"Policy: test_policy run: 1 has been rejected since allowed 3 concurrent runs are already in progress."`. **Supported Topology** * **1-to-1 Connection** Only one Active Artifactory Instance can be paired with one Archive Artifactory Instance. * **Active Artifactory Configuration** Active Artifactory Instance can only be a Platform or a Mothership, not an Edge. **Provider and Region Restriction** Archive Artifactory Instance must be of the same provider and region as the Active Artifactory Instance. **No Unbinding** Unbinding an Archive Artifactory Instance is not supported. **Conversion Restriction** Archive Artifactory Instance cannot be converted to other JPD types. **Unbinding Deleted/unavailable Archive Artifactory Instance** When an Active Artifactory Instance and an Archive Artifactory Instance are paired, and the Archive Artifactory Instance is no longer available (for example, it has been decommissioned or is unreachable), the usual binding revocation may fail. This is because the revocation request relies on the existence of the Archive Artifactory Instance to complete. If the Archive Artifactory Instance no longer exists, the binding cannot be deleted through standard means. Workaround: Refer to the Solution. ### Smart Archiving Known Issues This topic outlines the known issues of the smart archiving solution. **SBT Package** * When SBT packages are uploaded with the `sbt-default` repository layout, they are not resolved during archive actions. **Workaround**: Choose **Recommended Repository Layouts** as described in the [Create an sbt Repository](/artifactory/docs/sbt-repositories#create-an-sbt-repository). ### Smart Archiving Use Cases This topic outlines sample use cases for creating archive policies. It includes the type of use case, the scenario, the solution, and the expected result. These examples help you understand how to configure archive policies based on specific conditions for archiving packages.
Use Case Scenario Solution Result
Archiving Stale Packages Large repositories with many stale packages. Create an archive policy to archive stale packages.
  • Frees up storage
  • Keeps repositories clean
  • Restore for future use
Archiving Deprecated/EOL Versions of Packages Deprecated versions of packages that are no longer needed. Create an archive policy to archive deprecated/EOL versions.
Automating Archiving Old Packages Required to retain packages for a set period (for example, 6 months) for compliance. Create an archive policy to automate archiving packages based on:
    ions.
  • Ensures compliance with data retention policies/auditing/legal requirements
  • Frees up storage
  • Keeps repositories clean
  • Restore for future use
Archiving for Compliance and Audit Purposes Required to retain packages for auditing or legal reasons. Create an archive policy to archive all packages older than a set number of years (for example 2 years).
### Smart Archiving Architecture This topic outlines smart archiving architecture and its components. Smart_Archiving_Architecture.png The smart archiving solution is comprised of three main components: * **Active Artifactory Instance** Active Artifactory Instance is a standard Artifactory instance, the packages will be archived and restored Archive Artifactory Instance. * **Archive** The Archive policy periodically offloads packages based on specific criteria to the Archive Artifactory Instance. Moving these packages can enhance usability, search capabilities, and performance in the Active Artifactory Instance by reducing maintenance load. For more information, see [Manage Smart Archiving - Policies](#manage-smart-archiving---policies). * **Search and Restore** You can search for and restore archived packages. Restorations can be directed to the original location in the Active Artifactory Instance or to a new destination. The restore process runs in the background, while metadata associated with archived packages remains intact for continued access after restoration. For more information, see [Manage Restore Runs](#manage-restore-runs "Manage Restore Runs"). * **Archive Artifactory Instance** Archive Artifactory is a simplified version of an Artifactory instance designed specifically for archiving. It operates as a dedicated Artifactory instance connected to a binary storage provider, such as GCP Storage. ### **Note** An Archive Artifactory instance can connect to only one Active Artifactory instance. Each Artifactory cluster that requires archiving needs its own Archive Artifactory instance with a dedicated license. ### Archive Topology The smart archiving supports the topology of one Active Artifactory instance connecting to one Archive Artifactory instance. ### **Topology Not Supported** Smart Archiving does not support many Active Artifactory instances connecting to one Archive Artifactory instance. ### Smart Archiving Supported Packages This topic outlines the supported packages for Smart Archiving. It includes the policy conditions that apply to each package type. | Package Type | Supported Release Version | Lead Artifact | Age (Packages Older Than) | Usage (Packages Not Downloaded Since) | Version (Number of Latest Versions to Keep) | | :-------------------------------- | :------------------------ | :------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Agent Plugins | 7.157 | .zip | | | | | Alpine | 7.111.1 | .tar.gz, .apk | | | | | Ansible | 7.111.1 | tar.gz | | | | | Bower | 7.162 | – | | | | | Cargo | 7.111.1 | .crate | | | | | CocoaPods | 7.111.1 | .tar.gz, .tgz | | | | | Composer | 7.116 | – | | | | | Conan | 7.111.1 | conanfile.py | | | | | Conda | 7.111.1 | tar.bz2 | | | | | CRAN | 7.162 | .tar.gz | | | | | Debian | 7.111.1 | .deb, .ddeb | | | | | Docker | 7.111.1 | manifest.json | | |
Note Supported from Artifactory 7.115.1. | | Gems | 7.111.1 | .gem | | | | | Generic | 7.111.1 | – | | | | | Go | 7.111.1 | .mod | | | | | Gradle | 7.111.1 | .pom | | | | | Helm | 7.111.1 | .tgz | | | | | Helm OCI | 7.111.1 | manifest.json | | |
Note Supported from Artifactory 7.115.1. | | Hex | 7.111.1 | – | | | | | HuggingFaceML | 7.111.1 | .jfrog\_huggingface\_model\_info.json, .jfrog\_huggingface\_dataset\_info | | | | | Machine Learning | 7.111.1 | model-manifest.json | | | | | Maven | 7.111.1 | .pom | | | | | Nix | 7.162 | narInfo | | | | | npm | 7.111.1 | .tgz | | | | | NuGet | 7.111.1 | .nupkg | | | | | OCI | 7.111.1 | manifest.json | | |
Note Supported from Artifactory 7.115.1. | | PyPI | 7.111.1 | tar.gz, tgz, gz, whl, egg, bz2 | | | | | RPM | 7.111.1 | .rpm | | | | | SBT | 7.111.1 | .pom, .xml | | | | | Swift | 7.114.1 | – | | | | | Terraform | 7.111.1 | .zip | | | | | Terraform BE | 7.111.1 | .json | | | | | Vagrant | 7.111.1 | – | | | | **Docker Archive Method** Docker images can have multiple tags and use `list.manifests` to support different architectures. Each `list.manifest` points to several specific manifests for various systems. **Learn how the policy executes for the following conditions:** ### **Warning** We recommend that you avoid configuring **separate** archive policies with conflicting criteria (for example, one policy with **Keep Last N Versions** and another with **Packages Not Downloaded Since**) for the same Docker, OCI, or Helm OCI repository. Instead, combine time, property, and version conditions in a single policy by selecting multiple conditions from the multi-select group. * **Time-based Condition**: Time-based conditions archive images and tags that have not been used within a certain period. This helps keep the connections between tags intact and ensures the stability of multi-architecture references. Use the **Packages Not Downloaded Since** condition to prevent the archiving of images that are currently in use. * **Version-based Condition**: From Artifactory 7.115.1, version-based policy conditions for Docker, OCI, and Helm OCI are supported. It allows you to keep a specified number of image versions in the Docker repository, which considers the structure of Docker images when deciding what to archive. If a Docker image is a `list.manifest`, it will either be archived with all of its related sub-manifests or not archived at all. This approach maintains the relationships between images. This provides greater control over image management and helps maintain tag relationships and multi-architecture references. You can combine **Keep Last N Versions** with time-based and property conditions in a single policy. Versions among the last N are always kept on the active instance, even when they meet your time or property criteria. On the other hand, time-based conditions treat each manifest and `list.manifest` separately, without considering their hierarchical structure. Each one is evaluated independently based on its status. ### **Note** - **[Tag Retention Logic](/artifactory/docs/docker-repositories#use-tag-retention)**: When this logic is enabled, previous tag revisions (tag retentions) will be archived only when the most recent revision of a tag is archived. - [**Max Unique Tags Logic**](/artifactory/docs/docker-repositories#use-max-unique-tags): When this logic is enabled, the Last N Versions policy will take precedence. **Example**: With Last N Versions set to 2 and Max Unique Tags set to 5, the policy retains only 2 versions/tags of the same image after the policy is executed. ## Get Started with Smart Archiving This topic outlines how to get started with smart archiving. It includes how to configure the smart archiving solution, grant permission to a project admin, work with archive and restore, and monitor archive and restore operations. Smart_Archiving_GS.png
# Task Description Reference Links
1 Configure Archive Instance This topic describes how to create a new archive instance and connect it to an active instance. The archive instance is used in the smart archiving solution to offload archive items from the active instance. [Configure Smart Archiving Instance](#configure-smart-archiving-instance "Configure Smart Archiving Instance")
2 Grant Permission to a Project Admin to Create and Edit Archive Policies This topic outlines how to grant permission to a project admin. Platform admins can enforce and manage archive policies across multiple projects or all projects on the JFrog platform and thereby gain full control over organizational storage management (Global Policies). Platform admins can also delegate permissions to Project admins to manage policies on their project scope only (Project Policies), and Project admins have visibility on Global Policies affecting their projects. [Grant Permission to Project Admin](#grant-permission-to-project-admin "Grant Permission to Project Admin")
3 Work with Archive and Restore This section outlines working with Archive and Restore. It includes creating and managing archive policies, managing archive runs, searching and restoring archived packages and managing restore runs. [Work with Smart Archiving and Restore](#work-with-smart-archiving-and-restore "Work with Smart Archiving and Restore")
4 Monitor Archive and Restore This section outlines monitoring archive storage, archive and restore runs. [Monitor Smart Archiving and Restore](#monitor-smart-archiving-and-restore "Monitor Smart Archiving and Restore")
## Configure Smart Archiving Instance This section describes how to create a new archive instance and connect it to an active instance. The archive instance is used in the smart archiving solution to offload archive items from the active instance. Follow the relevant instructions for your deployment model to configure smart archiving: * [Configure Cloud Smart Archiving Instance](#configure-cloud-smart-archiving-instance) * [Configure Hybrid Smart Archiving Instance](#configure-hybrid-smart-archiving-instance "Configure Hybrid Smart Archiving Instance") ### Configure Cloud Smart Archiving Instance Use this path when both your active JFrog Platform and archive instance run on JFrog Cloud (SaaS). Create the archive server and associate it with your active Platform server in MyJFrog Topology. **To configure a cloud smart archiving instance:** * Follow the procedure in [Add Servers to Your Cloud Topology](/docs/manage-your-cloud-topology#add-servers-to-your-cloud-topology "Add Servers to Your Cloud Topology"). When you add the server, select **Smart Archiving** as the deployment type and associate it with your active JFrog Platform server in the **Associated Server** field. **Next steps:** * [Grant Permission to Project Admin](#grant-permission-to-project-admin "Grant Permission to Project Admin") ### Configure Hybrid Smart Archiving Instance Hybrid Smart Archiving is supported on the Self-hosted platform with E+ from version 7.117.14. **Prerequisite:** You must have an active Artifactory instance. Contact your Account Manager to purchase a JFrog E+ Hybrid subscription for your JFrog Smart Archive instance. Use this path when your active Artifactory instance is self-hosted and the archive instance is deployed in JFrog Cloud. Complete the following tasks to set up hybrid smart archiving: 1. [Provision the Archive Instance in MyJFrog](#provision-the-archive-instance-in-myjfrog "Provision the Archive Instance in MyJFrog"). 2. [Bind Archive Instance](#bind-archive-instance "Bind Archive Instance"). To revoke a binding or re-establish trust after initial setup, see [Manage Hybrid Smart Archiving Bindings](#manage-hybrid-smart-archiving-bindings "Manage Hybrid Smart Archiving Bindings"). #### Provision the Archive Instance in MyJFrog After you purchase a JFrog E+ Hybrid subscription, provision the archive instance in MyJFrog. ### **Important** Upon successful purchase, you will receive an email from JFrog with the subject line **Activate Your JFrog Hybrid Subscription**. **To provision the archive instance in MyJFrog:** 1. Click **Go to MyJFrog** in the received email. 2. Log in to **MyJFrog Your Customer Portal** with your registered credentials. 3. In the **My JFrog** Dashboard, click **Topology**. 4. On the **Topology** page, click **Configure Now**. 5. Scroll down on the **Configure JPDs** page to the **Available Smart Archiving Instance (x)** section. 6. In the **Archive Name** field, enter a meaningful name for the archive instance. The name must follow these conventions: * Unique name * 3-32 characters long * Start with a letter * Contain only lowercase letters or numbers 7. From the **Provider** list, select the cloud provider. 8. From the **Region** list, select the region. 9. Enter **Password** and **Validate Password**. The password must meet these criteria: * 8-32 characters long * At least one uppercase and one lowercase character * At least one number * At least one special character 10. Click **Update**. After you enter all required information, the dialog displays an **All Set** indicator. The Topology tab shows an indicator at the top that the JPDs are being added and the environment is being updated. This process may take a few minutes. When the configuration completes: * A tree structure displays the archive instance status as **Active**. * Upon successful Smart Archiving JPD creation, you will receive an email from JFrog with the subject line **Your New JFrog Instance Is Ready**. ### **Note** No changes are allowed to the instance configuration once configured. For changes, contact Customer Success. **Next steps:** * [Bind Archive Instance](#bind-archive-instance) ##### Archive instance fields The Topology page displays the following information for each configured archive instance: * **JPD Name**: The name of the active instance. * **Type**: Indicates the type of JPD. * **Provider**: Indicates the type of Cloud provider. * **Region**: Indicates the region of the deployed instance. * **Status**: Indicates the status of the instance. * **Active**: The archive instance is available to bind with the active instance. #### Bind Archive Instance You can bind the archive instance using one of these methods: * [Bind Archive Instance via UI](#bind-archive-instance-via-ui) * [Bind Archive Instance via API](#bind-archive-instance-via-api) ##### Bind Archive Instance via UI **To bind the archive instance via the UI:** 1. On the archive instance, generate a pairing token: 1. From **Administration**, click **User Management** > **Access Tokens** > **Pairing Token**. 2. From **Generate Pairing Token**, click **Cold Storage**. 3. Click **Generate**. The token window is displayed. It includes the token expiration (in seconds, set by default to 300 seconds = 5 minutes), the token ID, and the token value, which you can copy by clicking **Copy**. 2. On the active instance, establish trust with the archive instance: 1. [Register a Platform Deployment](/docs/manage-platform-deployments#register-a-platform-deployment). 2. From **Administration**, click **Topology** > **Deployment Bindings**. 3. Click the **Archive** tab. In the top right corner, click **+ Add Binding**, and select **Archive** from the dropdown list. 4. In the **Create Binding** modal, do the following: * From **Source JPD (Live Instance)**, select the active instance. * From **Target JPD (Cold Instance)**, select the archive instance. * Click **Apply**. The Summary displays the target and source you selected. 5. Click **Create**. 6. Check the **Binding Results**. ##### Bind Archive Instance via API **To bind the archive instance via the API:** On the archive instance, execute the following POST request to generate the pairing token: ```shell curl -u admin:password -X POST https:///artifactory/api/v1/service_trust/pairing/artifactory-cold ``` Where: * ``: The URL of the archive Artifactory instance. For example: ```json { "pairing_token":"IiwiYWxnIjoiUlMyNTYiLCJraWQiOiJaWkhkQzBzenlqd2d..."} ``` On the active instance, use the generated pairing token to execute the following PUT request: ```shell curl -u admin:password -X PUT -H "Content-Type: application/json" -d '{"pairing_token" : ""}' https:///artifactory/api/v1/service_trust/pairing/artifactory-cold ``` Where: * ``: The URL of the active Artifactory instance * ``: The pairing token returned from the archive instance. For example: ```shell curl -u admin:password -X PUT -H "Content-Type: application/json" -d '{"pairing_token" : "IiwiYWxnIjoiUlMyNTYiLCJraWQiOiJaWkhkQzBzenlqd2d..."}' https:///artifactory/api/v1/service_trust/pairing/artifactory-cold ``` If the two instances are paired successfully, the request returns the following status: Trust with service artifactory-cold was established successfully. **Next steps:** * [Grant Permission to Project Admin](#grant-permission-to-project-admin "Grant Permission to Project Admin") #### Manage Hybrid Smart Archiving Bindings Use this section after initial setup when you need to revoke a binding or re-establish trust between the active and archive instances—for example, when a pairing token was mistakenly revoked. **To revoke the binding between the active and archive Artifactory instances:** ### **Note** You cannot remove the binding between the Active Artifactory Instance and Archive Artifactory Instance if the Archive Artifactory Instance is no longer available. Perform the following steps on the active Artifactory instance: 1. From **Administration**, click **Topology** > **Deployment Bindings**, and then click the **Archive** tab. 2. Select the checkbox for the bindings you wish to remove, and then click the **Delete** icon. 3. Click **OK** to confirm. Your action is applied and the results of the unbinding are now displayed. **To re-establish trust between the active and archive Artifactory instances:** Re-establish trust when the pairing was revoked, such as when a token has been mistakenly revoked. Follow the same steps performed while binding for the first time as described in [Bind Archive Instance](#bind-archive-instance "Bind Archive Instance"). ## Grant Permission to Project Admin This topic outlines how to grant permission to a project admin. Platform admins can enforce and manage archive policies across multiple projects or all projects on the JFrog platform and thereby gain full control over organizational storage management (Global Policies). Platform admins can also delegate permissions to Project admins to manage policies on their project scope only (Project Policies), and Project admins have visibility on Global Policies affecting their projects. **Global Policy**: For maintaining consistent archive policies across multiple projects, ensuring compliance and standardization. * **Scope**: Applies to all packages across the entire Artifactory instance. * **Configuration**: Set by platform administrators and affects all projects at global level. **Project Policy**: For addressing unique archive policies for a project that differ from the global standard, allowing flexibility to project administrators. * **Scope**: Applies to individual projects. * **Configuration**: Set by project/platform administrators for specific needs and requirements of a project. **To grant permissions to project admins, follow these steps:** 1. From the **Administration** module, click **Projects**. 2. In the Projects screen, select the project where you want to give permissions to the Project Admin. The project details appear in read-only mode. 3. Click **Edit Settings** in the upper right of the project details screen. 4. Go to the section **Project Admins**, and then click **Manage Resources**. 5. Add the user to the project from the **Users** tab. 6. Click **Save**. ## Smart Archiving - User Activities and Authorizations This topic outlines smart archiving user activities and their authorizations. ### Configure Archive Instance and Grant Permission to Project Admin | Activity | Platform Admin | Project Admin | Application User | | :------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------ | | [Configure Smart Archiving Instance](#configure-smart-archiving-instance "Configure Smart Archiving Instance") | ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) | ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) | ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) | | [Grant Permission to Project Admin](#grant-permission-to-project-admin "Grant Permission to Project Admin") | ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) | ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) | ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) | ### Create Archive Policy
Activity Platform Admin Project Admin Application User
[Create Smart Archiving Policy](#create-smart-archiving-policy "Create Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note**: Only from allocated projects ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Manage Smart Archiving - Policies
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[Edit Smart Archiving Policy](#edit-smart-archiving-policy "Edit Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Enable/Disable Smart Archiving Policy](#enabledisable-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Edit Smart Archiving Policy](#edit-smart-archiving-policy "Edit Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop Running Smart Archiving Policy](#stop-running-smart-archiving-policy "Stop Running Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Delete Smart Archiving Policy](#delete-smart-archiving-policy "Delete Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report "Download Smart Archiving Policy Last Run Report") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Disable All Smart Archiving Policies](#disable-all-smart-archiving-policies "Disable All Smart Archiving Policies") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Search Smart Archiving Policy](#search-smart-archiving-policy "Search Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Manage Smart Archiving - Runs
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[View All Smart Archiving Runs](#view-all-smart-archiving-runs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Search and Restore Archived Packages
Activity Platform Admin Project Admin **Note:** Available from Version 7.123. Application User
[Search Archived Packages](#search-archived-packages) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Restore Archived Packages](#restore-archived-packages) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Manage Restore Runs
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[View All Restore Runs](#view-all-restore-runs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download and Review Restore Run Report](#download-and-review-restore-run-report) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Monitor Smart Archiving and Restore
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[Monitor Smart Archiving Storage Info](#monitor-smart-archiving-storage-info) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Monitor Smart Archiving and Restore - via UI and Logs](#monitor-smart-archiving-and-restore---via-ui-and-logs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
Depending on your role, you can perform the operations described in this section within the following contexts: **Global Context** **Project Context** ## Work with Smart Archiving and Restore This section outlines working with Archive and Restore. It includes creating and managing archive policies, managing archive runs, searching and restoring archived packages and managing restore runs. Smart_Archiving_Workflow.png
# Task Description For UI, see... For API, see...
1 **Create Smart Archiving Policy** This topic outlines how to create a smart archiving policy. You create the smart archiving policy to archive unintended packages from Active Artifactory Instance to Archive Artifactory Instance. [Create Smart Archiving Policy](#create-smart-archiving-policy) [Create Smart Archiving Policy API](/reference/createsmartarchivingpolicy)
2 **Manage Smart Archiving - Policies** This section outlines the actions you can perform on the smart archiving Policies from the Active Artifactory Instance. It includes enable/disable, search, manual run, dry run, edit, stop, delete, view and delete policies. [Manage Smart Archiving - Policies](#manage-smart-archiving---policies) N/A
3 **Manage Smart Archiving - Runs** This section outlines the actions you can perform on the smart archiving Runs from the Active Artifactory Instance. It includes view, stop all runs and downloading run reports. [Manage Smart Archiving - Runs](#manage-smart-archiving---runs) N/A
4 **Search and Restore Archived Packages** This section outlines the actions you can perform on the global search bar from the Active Artifactory Instance. It includes searching and restoring archived packages. [Search and Restore Archived Packages](#search-and-restore-archived-packages) - [Search for Archived Packages](/docs/archive#search-for-archived-packages) - [Restore Archived Packages API](/reference/restorearchivedpackages)
5 **Manage Restore Runs** This section outlines the actions you can perform on the Restore Runs from the Active Artifactory Instance. It includes view, stop all runs and downloading run reports. [Manage Restore Runs](#manage-restore-runs) N/A
### Create Smart Archiving Policy This topic outlines how to create a smart archiving policy. You create the smart archiving policy to archive packages from Active Artifactory Instance to Archive Artifactory Instance. Ideal_Smart_Archiving_Workflow.png ### Authorization
Activity Platform Admin Project Admin Application User
[Create Smart Archiving Policy](#create-smart-archiving-policy "Create Smart Archiving Policy") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note**: Only from allocated projects ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
**To create Archive policies:** ### **Important** **Archive Evidence** From Artifactory Version 7.117, added support for the archival of evidence associated with any packages. This enhancement ensures that relevant evidence is preserved as part of your archiving strategy, streamlining your package management process. **Note** In Artifactory versions before 7.117, if you archive packages that have associated evidence, the evidence will not be archived. When restoring packages archived in these earlier versions, only the packages themselves will be restored, and any associated evidence will not be restored. 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, from the **Create Policy** dropdown list, click **Archive Policy**. 3. Configure the following in the **Create New Archive Policy** page:
Field Description Media
_Policy Name_ Enter a unique and meaningful name for the policy. ![](https://files.readme.io/a4f6994f1d34ca59ec68334141b0ab2e3157590e2ef2ffdcc9c8b5a34cb703e0-image.png)
_Description_ Enter information regarding why this policy was created, and details that help users understand its configuration.
**Policy Scope** ![](https://files.readme.io/b7f75ad6e1f69961441b1353fdea50b971cf2f3363a2725e97a204315cee82f9-Smart-Archive_create-policy_Policy-Scope_with-Stages.png)
_Include Stages / Include All Stages_ Select the [stages](/docs/stages-lifecycle) to which the policy should apply, or choose **Include All Stages** to run the policy across all stages on the platform.
_Include Projects / Include All Projects_ ### **Note** This setting is applicable only at the global level for Platform Admins. It does not appear when creating a policy at the project level. When this setting is visible, it is mandatory. Select the projects to which the policy should apply, or choose **Include All Projects** to run the policy across all projects on the platform. You can also select **Unassigned Repositories** to apply the policy to repositories not linked to any projects.
_Package Types_ Select one or more of the package types you want to archive. ### **Note** If a policy includes a repository with retention settings, packages designated for retention may be inadvertently removed.
_Include Repository Patterns_ - Enter one or more patterns for the repository names where you want the archive policy to apply, then click **Add**. Alternatively, you can select **Include All Repositories** or specify explicit repository names. At least one pattern or explicit name is required, as only packages in repositories matching these will be archived. - Auto-complete will suggest options based on the project and package type, and both local and federated repositories are supported. **Warning** If the policy includes a local repository configured for remote push replication, deletions will be replicated to the remote targets. ### **Note** It is not possible to specify a path within a repository. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `npm-local*` includes all repositories starting with **npm-local**. Regex is not supported.
_Exclude Repository Patterns_ Enter patterns or explicit repository names to exclude from the archive policy. Auto-complete will suggest options based on the project and package type. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `npm-local*` excludes all repositories starting with npm-local. Regex is not supported.
_Include Path Patterns_ (Optional) Enter one or more folder paths to include in the archive policy. Use this option to narrow the policy scope to specific repository paths within the defined repositories. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `npm-local*` excludes all repositories starting with npm-local. Regex is not supported.
_Exclude Path Patterns_ (Optional) Enter one or more folder paths to exclude from the archive policy. Use this option to include all packages within the defined repositories except for the packages whose path matches the exclude patterns. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `npm-local*` excludes all repositories starting with npm-local. Regex is not supported.
_Include Package Name Pattern_ Enter a pattern for a package name or an explicit package name for the archive policy, then click **Add** or select **Include All Packages**. Only one pattern or explicit name is allowed. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `mypackage*` includes all packages starting with mypackage. Regex is not supported.
_Exclude Package Name_ Enter explicit package names to exclude from the policy and click **Add**. Only explicit names are accepted and not patterns.
_Include Package Version Pattern_ Enter a pattern for a package version or an explicit package version for the policy, or select **Include All Versions**. ### **Note** **Set Patterns**: Use wildcards at the end to match any suffix, or at the start to match any prefix. **For example**, `1.0.*` includes all packages starting with 1.0. Regex is not supported. Only 1 pattern or explicit version can be entered. Available from V 7.127 (Cloud) and V 7.125.7 (Self-managed).
_Exclude Package Version Patterns_ Enter explicit package version to exclude from the policy. Only explicit versions are accepted and not patterns. Available from V 7.127 (Cloud) and V 7.125.7 (Self-managed).
**Policy Conditions** Select **one or more** conditions from the multi-select group. Time, property, and version criteria are evaluated using logical **AND**. The policy targets packages that meet all selected time and property conditions and fall outside the protected version history. - **Packages Older Than** - **Packages Not Downloaded Since** - **Property** - **Keep Last N Versions** ![](https://files.readme.io/a66775050be485bb32060d9b18cde6d8a81b5cb251e7b2c3f8daea79fae23021-image.png)
Policy Conditions Select **one or more** of the following conditions: - **Packages Older Than**: Archives packages based on their creation date, regardless of whether they have been downloaded. - **Packages Not Downloaded Since**: Archives packages based on their last download date. The default is 2 years. If a package was never downloaded, it is archived only if its creation date is older than the specified **Not Downloaded Since** period. We recommend using this condition to prevent the archiving of packages currently in use. - **Property**: Archives packages based on a property key-value pair applied to the lead artifact. For more information, see [Smart Archiving Supported Packages](#smart-archiving-supported-packages). - **Keep Last N Versions**: Defines the number of latest versions to keep. The archive policy excludes the N most recent versions from archiving. The latest version is always excluded. When combined with time or property conditions, only packages that meet those criteria **and** fall outside the retained version set are archived. ### **Note** A day in this context is a 24-hour period from the moment the policy is executed. Other units are calculated as follows: - 1 week = 7 days - 1 month = 30 days - 1 year = 365 days The system will convert them to appropriate time unit if the matching value is entered. For example, if you enter 7 days, the system changes it to 1 week. ### **Notes for Keep Last N Versions** - Versions are determined by creation date. - Not all package types support this condition. For more information, see [Smart Archiving Supported Packages](#smart-archiving-supported-packages). - If your archive policy includes a version-based condition (for example, keep last N versions), be aware that a change in behavior in Helm client 3.18.0 and later causes Helm to create two manifest nodes per version. One is for the tag and one is for the digest. This affects any OCI-compliant repository where Helm charts are stored, including Helm OCI and Docker repositories. Since Artifactory counts each manifest node as a separate version, the policy may retain digest references instead of the human-readable tags used for consumption. **Behavioral logic when multiple conditions are selected** All selected conditions are evaluated together using logical **AND**: - If you select both **Packages Older Than** and **Packages Not Downloaded Since**, the policy archives only packages that meet both conditions. Packages that have never been downloaded are archived only if their creation date is older than the **Packages Older Than** value. - If you also select **Keep Last N Versions**, packages among the last N versions for their package path are never archived, even when they meet the time and property criteria. This acts as a safety rail to prevent total depletion of a package's version history on the active instance. - When **Property** is selected with time-based conditions, packages must match the property **and** satisfy the selected time criteria to be eligible for archiving. **Example:** You select **Packages Older Than** 12 months, **Property** `prod=true`, and **Keep Last 5 Versions**. The policy archives only packages that are older than 12 months, have the property `prod=true`, and are not among the five most recent versions of their package.
_Exclude based on property_ Enable the checkbox and enter the property name and value applied to the lead artifact of a package. Packages with this property will be excluded from archiving. For more information, see [Smart Archiving Supported Packages](#smart-archiving-supported-packages "Smart Archiving Supported Packages").
**Additional Settings**
_Cron Expression_ A cron expression is a string comprised of five or six fields separated by spaces. Each field represents a different unit of time, which collectively define the schedule for policy execution. The standard format is as follows: ``` * * * * * * (Seconds - Optional) | | | | | | | | | | | +---- Day of the week (0 - 6) (Sunday=0) | | | | +------ Month (1 - 12) | | | +-------- Day of the month (1 - 31) | | +---------- Hour (0 - 23) | +------------ Minute (0 - 59) +-------------- Second (0 - 59) (Optional) ``` ### **Note** This cron expression must follow the Quartz scheduler format as used in the CronTrigger class. It differs from the standard Unix cron format. For example, Quartz supports a sixth optional field for seconds and uses **?** for non-specific values. Refer to the Quartz documentation for more details: Quartz Cron Expression Format. **Example Cron Expression** To illustrate how to construct a cron expression, consider the following example: **Expression**: `0 0 2 * * ?` - 0 - At second 0 - 0 - At minute 0 - 2 - At hour 2 (2:00 AM) - - - Every day of the month - - - Every month - ? - No specific value for the day of the week This expression schedules the policy to run every day at 2:00 AM. **Guidelines for Scheduling** - **Run Interval**: The minimum interval between policy executions is 6 hours. If you attempt to set a cron expression that results in a runtime shorter than this duration, you will encounter an error when saving the configuration. - **Off-Hours Scheduling**: It is recommended to tune your cron expression so that policies run during off-hours. This helps to reduce the impact on system performance during peak usage times. **Leaving the Cron Expression Empty**: If you leave the cron expression empty, you can only [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually") manually. This means that there will be no automatic scheduling and the policy will not run unless you initiate it. ![](https://files.readme.io/2d4be987a4384658b5a04db46ad22adbb001adb2e517817e71fe145a1c1f0942-uuid-f5f31e97-e0fe-ecb2-e4eb-2e2968f21c02.png)
_Max Run Duration_ This setting limits the maximum duration the policy can run when enabled. The maximum allowed duration is 5 hours. ### **Note** The policy stops before the completion of the run if it exceeds the applied run duration. In one run, within this duration, it archives all or part of your packages depending on the size and number of items. If there are any pending packages to be archived, they are archived incrementally in the next scheduled run and the subsequent runs.
_Skip Trash Can_ When enabled, this setting will cause packages to be permanently deleted from Artifactory instance without an option to restore them immediately after the archive policy is executed, bypassing the Trash Can repository. For more information on restoring packages, see [Restore Archived Packages](#restore-archived-packages "Restore Archived Packages"). ### **Note** If you want deleted items to be transferred to the trash can, you must enable the global Trash Can setting. For more information, see [Trash Can Settings](/installation/docs/general-settings#trash-can-settings). The packages are copied from Active Artifactory Instance to Archive Artifactory Instance, and then deleted in the Active Artifactory Instance.
4. Click **Save** to save the policy. If the policy includes a local repository configured for remote push replication, deletions will be replicated to the remote targets. The newly created smart archiving policy appears in the **Policies** list and executes on the scheduled date and time. * [Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy): This feature allows you to see which items would be archived without actually archiving them. We recommend performing a dry run and reviewing the results before enabling a policy. * [Enable/Disable Smart Archiving Policy](#enabledisable-smart-archiving-policy): The policy must be enabled to run automatically according to the schedule or [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually) manually. #### What Happens After the Smart Archiving Policy is Created? This topic outlines what happens after a smart archiving policy is created. **After the Smart Archiving policy has been defined and created:** * Enabled smart archiving policies execute on the scheduled date and time. The archiving policy can also be manually executed. For more information, see [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually"). ### **Note** We recommend not to run more than 10 policies at the same time. The Archive policy does not execute when an ongoing mandatory task is in progress (for example, Garbage Collection). If you want to manually [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually") or [Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy "Perform Dry Run on Smart Archiving Policy"), try at a later time. * The system archives the packages, along with the associated metadata, and moves them to the Archive Artifactory Instance. * When an item is archived, the system dynamically creates dedicated archiving repositories in the Archive Artifactory Instance. * As the archive process progresses, [View All Smart Archiving Runs](#view-all-smart-archiving-runs "View All Smart Archiving Runs") from the Active Artifactory Instance. ### Manage Smart Archiving - Policies This section outlines the actions you can perform on the smart archiving Policies from the Active Artifactory Instance. It includes enable/disable, search, manual run, dry run, edit, stop, delete, view and delete policies. The following table lists all the possible actions on the policies and their equivalent links to REST API. | Task | Description | For UI, see... | For API, see... | | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------- | | **View All Policies** | This section outlines how to view all smart archiving policies. It guides you in reviewing key details such as the policy status, associated projects with the policy, timestamps for the last and next scheduled runs, last run status, actions performed on each policy, and options for customizing table columns. | [View All Smart Archiving Policies](#view-all-smart-archiving-policies "View All Smart Archiving Policies") | [Get All Smart Archiving Policies API](/reference/getallsmartarchivingpolicies) | | **Perform a Dry Run** | This section outlines how to perform a dry run on a smart archiving policy. A dry run lets you preview which packages will be archived based on your defined policy criteria, without performing the actual archiving. This helps you understand the potential outcome before executing the policy. After the dry run, a **CSV** report is generated, listing all packages that would be archived along with relevant details. Review this list to decide whether to proceed with the policy or adjust the settings. | [Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy "Perform Dry Run on Smart Archiving Policy") | [Run Smart Archiving Policy API](/reference/runsmartarchivingpolicy) | | **Download the Last Run Report** | This section outlines how to download the last run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the archived packages. | [Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report "Download Smart Archiving Policy Last Run Report") | [Download Smart Archiving Policy Run Report API](/reference/downloadsmartarchivingpolicyrunreport) | | **Enable/Disable Policy** | This topic outlines how to enable/disable a smart archiving policy. By default, newly created archive policies are disabled. You must activate a policy before it can execute automatically according to the schedule or be triggered manually. | [Enable/Disable Smart Archiving Policy](#enabledisable-smart-archiving-policy) | [Enable/Disable Smart Archiving Policy API](/administration/reference/enabledisablesmartarchivingpolicy) | | **Run Now** | This topic outlines how to run a smart archiving policy manually. In addition to the periodic automated execution of the smart archiving policy that occurs if you enable the policy and set its Cron Expression, you can also manually run the archive policy at any time. | [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually") | [Run Smart Archiving Policy API](/reference/runsmartarchivingpolicy) | | **Search Policies** | This topic outlines how to search smart archiving policy to locate the desired policy easily. | [Search Smart Archiving Policy](#search-smart-archiving-policy "Search Smart Archiving Policy") | [Get Single Smart Archiving Policy by Key API](/administration/reference/getsmartarchivingpolicy) | | **Disable All Policies** | This topic outlines how to disable all smart archiving policies. As a Platform Admin, you can disable all policies globally, making them inactive. Once this is done, you can activate policies individually as needed. | [Disable All Smart Archiving Policies](#disable-all-smart-archiving-policies "Disable All Smart Archiving Policies") | [Disable All Smart Archiving Policies API](/reference/disableallsmartarchivingpolicies) | | **Edit Policy** | This topic outlines how to edit a smart archiving policy. After a smart archiving policy has been created, you can change the settings or archive criteria. | [Edit Smart Archiving Policy](#edit-smart-archiving-policy "Edit Smart Archiving Policy") | [Update Smart Archiving Policy API](/reference/updatesmartarchivingpolicy) | | **Stop Policy** | This topic outlines how to stop a running smart archiving policy. For some reason, you may want to stop the smart archiving policy that is currently running before it finishes completion. | [Stop Running Smart Archiving Policy](#stop-running-smart-archiving-policy "Stop Running Smart Archiving Policy") | [Stop Running Smart Archiving Policy API](/reference/stoprunningsmartarchivingpolicy) | | **Delete Policy** | This topic outlines how to delete a smart archiving policy. If you decide that the smart archiving policy is no longer needed, you can delete it. | [Delete Smart Archiving Policy](#delete-smart-archiving-policy "Delete Smart Archiving Policy") | [Delete Smart Archiving Policy API](/reference/deletesmartarchivingpolicy) | | **Stop All Runs** | This topic outlines how to stop all smart archiving policy runs. You can perform this action from the policies tab and runs tab. As a Platform Admin, you can stop all currently running policies. Once a policy run is stopped, it cannot resume from its last point. You must restart the policy from the beginning to rerun it. | [Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs "Stop All Smart Archiving Policy Runs") | [Stop All Running Smart Archiving Policies API](/reference/stopallrunningsmartarchivingpolicies) | ### Authorization
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[Edit Smart Archiving Policy](#edit-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Enable/Disable Smart Archiving Policy](#enabledisable-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Edit Smart Archiving Policy](#edit-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop Running Smart Archiving Policy](#stop-running-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Delete Smart Archiving Policy](#delete-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Disable All Smart Archiving Policies](#disable-all-smart-archiving-policies) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Search Smart Archiving Policy](#search-smart-archiving-policy) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
#### View All Smart Archiving Policies This section outlines how to view all smart archiving policies. It guides you in reviewing key details such as the policy status, associated projects with the policy, timestamps for the last and next scheduled runs, last run status, actions performed on each policy, and options for customizing table columns. **To view all smart archiving policies:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. Under the **Policies** tab, you can view all the policies. ### Archive Policy Table Fields The following table describes the columns of the archive policy table fields.
Field Description
**Policy Name** Indicates the name of the policy.
**Project** Indicates the name of the project. **Note**: **Unassigned Repos**: Only repositories not assigned to a project will be affected.
**Last Run Status**

Indicates the status of each policy execution, which can be one of the following:

Last Run Status
    -8a43-85dc-6fe9663c1ac3.png" width="20" height="20" /> -8a43-85dc-6fe9663c1ac3.png" width="20" height="20" /> -55c1-bcd4-da615b12c40c.png" width="20" height="20" /> the logs for details. -475d-68ac-833a2f186f44.png" width="20" height="20" /> -406e-f32c-408adbae1faf.png" width="20" height="20" /> -475d-68ac-833a2f186f44.png" width="20" height="20" /> -2934-3635-794c718ff632.png" width="20" height="20" /> -2934-3635-794c718ff632.png" width="20" height="20" /> -4db1-fb97-780e9e8a094c.png" width="20" height="20" />
**Next Run** Indicates the next scheduled run.
**Enabled** Indicates whether the policy is enabled or disabled.
    as been enabled. You can run the policy manually or it runs according to the defined schedule. has been disabled. You can perform dry run but not manual or scheduled runs.
### More Actions - Icon Status From the more icon you can perform various actions on the policies. The status of the icon is as follows:
Icon Status Description
![](https://files.readme.io/5e67fb5486d9723a3b1427c5a5ce0e547845d534ab1e692fcfcc3824e75d3ad6-uuid-cf476e7f-04e9-d691-b52a-02c7ca121e41.png) Active

The more actions have been active. Following are the actions you can perform on a policy:

    . ased on the Last Run Status to review:
![](https://files.readme.io/187cd9cd07d707cd02076a2b61b488d324e19488b0062dafe169ff2abe670b59-uuid-d6b0c48d-dddc-3833-52e3-1f9913f2d15a.png) Hover Hovered the mouse pointer over more icon
![](https://files.readme.io/e66e4a957c61059804e6dcc289f72739ec11f0a0aeb8b4f2e2ad0dc09c91caf4-uuid-09da0980-16e1-b2ba-1299-4aa531eec701.png) Disabled The more actions have been disabled.
![](https://files.readme.io/4fcea89240f93d3abec0380d2c1ef0211ec46f2d8d885e7e6effec859ec3e97b-uuid-203fff7e-3c7e-ccc9-e5cc-a69f49708829.png) New Indicates the policy is newly created.
### Customize Table Columns Arrange the table columns according to how you want to view them. **To display and arrange the columns:** 1. From the Table header, click the **Customize Columns** at the end. 2. Select which columns to display in the Customize Columns pop-up and drag and drop to reorder them. 3. Click **Apply**. ![HC\_ViewAllPoliciesCustomizeColumns.png](https://files.readme.io/aa2de0b36f2565ba1ecee20148d0fd010cc5aca35122fd18f9503a6128602886-uuid-4375c829-448b-7d3f-427f-d309835f3b73.png) ### Refresh Policies To refresh policies, click the **Refresh** icon in the top-right corner of the table header. ![HC\_ViewAllPoliciesRefresh.png](https://files.readme.io/df3b72aa4978b5e78049352514dfb8d100b6c119c0e6388848fd696bf41ea333-uuid-ed007317-7118-7c65-4273-6a3c8143bbf7.png) #### Search Smart Archiving Policy This topic outlines how to search for a smart archiving policy to locate the desired policy easily. **To search the smart archiving policy:** 1. From the Administration module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. Click the **Policies** tab, enter the policy name in the **Search** field, and then press enter on the keyboard. HC_ViewAllPoliciesSearch.png #### Perform Dry Run on a Smart Archiving Policy This section outlines how to perform a dry run on a smart archiving policy. A dry run lets you preview which packages will be archived based on your defined policy criteria, without performing the actual archiving. This helps you understand the potential outcome before executing the policy. After the dry run, a **CSV** report is generated, listing all packages that would be archived along with relevant details. Review this list to decide whether to proceed with the policy or adjust the settings. ### **Note** - We recommend performing a dry run and reviewing the results before activating a policy to prevent unintended archive. - Dry run results reflect the specific point in time when the dry run is performed. The results of an actual policy execution may differ, as it occurs at a later scheduled time. **To perform a dry run on a smart archiving policy:** 1. From the Administration module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to run, click **•••** icon and then click **Perform a Dry Run**. ![HC\_ViewAllPoliciesDryRun.png](https://files.readme.io/1c8cd570033972d6b167dfdf8d7c07524c1f8de061a95bb5912eceac858d8342-uuid-3e8d863e-57c9-e224-25ca-aeb525a11575.png) 4. After the dry run is completed: 1. Download the report from [Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report "Download Smart Archiving Policy Last Run Report") or [Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report "Download and Review Smart Archiving Run Report"). 2. Review its status report, as explained in [Smart Archiving Run Report Overview](#smart-archiving-run-report-overview "Smart Archiving Run Report Overview"). #### Enable/Disable Smart Archiving Policy This topic outlines how to enable/disable a smart archiving policy. By default, newly created archive policies are disabled. You must activate a policy before it can execute automatically according to the schedule or be triggered manually. ### **Note** We recommend that you first perform a dry run and review its results before you enable a policy. This helps prevent unintended deletion. For more information on performing a dry run, see [Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy "Perform Dry Run on Smart Archiving Policy"). **The following actions can be performed on a disabled policy:** * [Perform Dry Run on Smart Archiving Policy](#perform-dry-run-on-smart-archiving-policy "Perform Dry Run on Smart Archiving Policy") * [Edit Smart Archiving Policy](#edit-smart-archiving-policy "Edit Smart Archiving Policy") * [Delete Smart Archiving Policy](#delete-smart-archiving-policy "Delete Smart Archiving Policy") **To enable or disable the smart archiving policy:** 1. From the Administration module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to enable/disable, and then toggle the slider ![](https://files.readme.io/9cf28ef5fb15160e43c1c4ebcbc5f41b96b2c2e1cbf989d0cad07fd5543a83c0-uuid-d1593ad6-79de-8546-7db6-75f4fbf31cd3.png) under the **Active** column. ![HC\_ViewAllPoliciesEnable.png](https://files.readme.io/00a5f73313ed4db6e5a89d7a753d922b492300040bd8651ade14e563fe771233-uuid-191abab2-bcbf-c96d-4d12-6712651b2073.png) Once enabled, the policy will run automatically based on the schedule you set during creation. You can also run it manually, as detailed in the [Run Smart Archiving Policy Manually](#run-smart-archiving-policy-manually "Run Smart Archiving Policy Manually"). #### Disable All Smart Archiving Policies As a Platform Admin, you can disable all smart archiving policies globally, making them inactive. Once this is done, you can activate policies individually as needed. ### **Note** The option to disable all policies is not available to Project Admins. The **Disable All Policies** option can be viewed in the global context only. **To disable all the smart archiving policies:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, click **Global Stop/Disable** dropdown list, and then click **Disable All Policies**. ![HC\_ViewAllPoliciesDisableAllPolicies.png](https://files.readme.io/cbb645742e8496d43c8eb766d1c3250895fe9b8b159c7d94510384710d466611-uuid-c950eef2-9491-2171-ec24-dfb6742ba616.png) 4. Check the **Active** column in the policies list to verify that all policies are now disabled. #### Run Smart Archiving Policy Manually In addition to the periodic automated execution of the smart archiving policy that occurs if you enable the policy and set its Cron Expression, you can also manually run the archive policy at any time. ### **Note** To manually run a smart archiving policy, the policy must first be activated. For more information, see [Enable/Disable Smart Archiving Policy](/docs//archive#enabledisable-smart-archiving-policy). **To run the smart archiving policy manually:** 1. From the Administration module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to run, click **•••** icon and then click **Run Now**. ![HC\_ViewAllPoliciesRunNow.png](https://files.readme.io/be5d5cdaa197835b2c6ea86573fcd2d6dd039fceedbd48330fe4598e9fc4d34c-uuid-9feb33c3-282a-6b84-060b-4d312bf74a99.png) 4. After the run is completed: 1. Download the report from [Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report "Download Smart Archiving Policy Last Run Report") or [Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report "Download and Review Smart Archiving Run Report"). 2. Review its status report, as explained in [Smart Archiving Run Report Overview](#smart-archiving-run-report-overview "Smart Archiving Run Report Overview"). #### Download Smart Archiving Policy Last Run Report This section outlines how to download the last run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the archived packages. **To download the report:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy for which you want to download the report, click **•••** icon, and then click **Download Last Report**. ![HC\_ViewAllPoliciesDownloadLastReport.png](https://files.readme.io/13b42864690935f0e344acd268e7717a6e7c91733f62cb69cac6dbdb54f075d7-uuid-1cc92451-7109-47a2-aeea-cccc5e966edb.png) A zip file is downloaded including one **.csv** files. 4. After the run is completed: 1. Download the report from [Download Smart Archiving Policy Last Run Report](#download-smart-archiving-policy-last-run-report "Download Smart Archiving Policy Last Run Report") or [Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report "Download and Review Smart Archiving Run Report"). 2. Review its status report, as explained in [Smart Archiving Run Report Overview](#smart-archiving-run-report-overview "Smart Archiving Run Report Overview"). #### Stop Running Smart Archiving Policy You have the option to stop the smart archiving policy that is currently running before it finishes completion. ### **Note** Once a policy has been stopped, it cannot resume from the point where it stopped. The only way to run the policy again is to restart it from the beginning. **To stop the running smart archiving policy:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to stop, click **•••** icon and then click **Stop**. ![HC\_ViewAllPoliciesStop.png](https://files.readme.io/4631ec33115ee8ef884b710db6e00f7aa783d834b5fdc77fd2eb0563685d1a68-uuid-c10458f1-ea9c-ae7c-2593-1bd519a1a915.png) 4. In the **Status** column of **Runs** tab, the status changes to **Stopped** for that run. #### Stop All Smart Archiving Policy Runs You can stop all smart archiving policy runs from either the Policies tab or the Runs tab. As a Platform Admin, you can stop all currently running policies. Once a policy run is stopped, it cannot resume from its last point. You must restart the policy from the beginning to rerun it. ### **Note** The option to stop all running policies is not available to Project Admins. The **Stop All Runs** option can be viewed in the global context only. **To stop all the smart archiving policy runs:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, click **Global Stop/Disable**, and then click **Stop All Runs**. To verify that all runs have stopped, under the **Policies** tab, check the **Last Run Status** column to ensure that all runs have stopped. ![HC\_ViewAllPoliciesStopAllRuns.png](https://files.readme.io/f9472e1717b53533667b41e71ba27f9e0c4fa6ab82f7a04f8ad9c3bc3a387f00-uuid-3f76695e-68b9-b67b-09cf-13587387b97e.png) #### Edit Smart Archiving Policy After a smart archiving policy has been created, you can change the settings or archive criteria. ### **Note** You cannot update a running policy. If you want to update a policy that is running, you need to either wait for the run to complete or [Stop Running Smart Archiving Policy](#stop-running-smart-archiving-policy "Stop Running Smart Archiving Policy"). **To edit the smart archiving policy:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to edit, click **•••** icon and then click **Edit**. Edit ``** Archive Policy** page appears. ![HC\_ViewAllPoliciesEdit.png](https://files.readme.io/1e63d6bb44abeed8fa0d3201d4718af5c0a98ae413567e757ec11383180a19a1-uuid-f00ba6ec-a394-3e97-4189-2a94f44f4a86.png) 4. In the ``** Archive Policy** page, update the settings as needed, and then click **Save**. If the policy includes a local repository configured for remote push replication, deletions will be replicated to the remote targets. HC_ViewAllPoliciesEditPolicy.png #### Delete Smart Archiving Policy If you decide that the smart archiving policy is no longer needed, you can delete it. ### **Note** You cannot delete a running policy. If you want to delete a running policy, you need to either wait for the run to complete or [Stop Running Smart Archiving Policy](#stop-running-smart-archiving-policy "Stop Running Smart Archiving Policy"). **To delete the smart archiving policy:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, under **Policies**, locate the policy you want to delete, click **•••** icon and then click **Delete**. The policy is deleted and removed from the **Policies** list. HC_ViewAllPoliciesDelete.png ### Manage Smart Archiving - Runs This section outlines the actions you can perform on the smart archiving Runs from the Active Artifactory Instance. It includes view, stop all runs and downloading run reports.
Task Description For UI, see... For API, see...
**View All Archive Runs** This section outlines how to view the status of both past and ongoing smart archiving runs. It provides guidance on how to review specific details, including the items that have been archived, the associated timestamps, the status of each archive operation, customizing table columns, and applying filters to view the desired information. [View All Smart Archiving Runs](#view-all-smart-archiving-runs "View All Smart Archiving Runs")
**Stop All Archive Policy Runs** This topic outlines how to stop all smart archiving policy runs. You can stop all currently running policies. Once a policy run is stopped, it cannot resume from its last point. You must restart the policy from the beginning to rerun it. [Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs "Stop All Smart Archiving Policy Runs") [Stop All Running Smart Archiving Policies API](/reference/stopallrunningsmartarchivingpolicies)
**Download and Review Archive Run Report** This section outlines how to download a smart archiving run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the archived packages. [Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report "Download and Review Smart Archiving Run Report") [Smart Archiving Run Report Overview](#smart-archiving-run-report-overview "Smart Archiving Run Report Overview")
### Authorization
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[View All Smart Archiving Runs](#view-all-smart-archiving-runs "View All Smart Archiving Runs") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Stop All Smart Archiving Policy Runs](#stop-all-smart-archiving-policy-runs "Stop All Smart Archiving Policy Runs") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download and Review Smart Archiving Run Report](#download-and-review-smart-archiving-run-report "Download and Review Smart Archiving Run Report") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
#### View All Smart Archiving Runs This section outlines how to view the status of both past and ongoing smart archiving runs. It provides guidance on how to review specific details, including the items that have been archived, the associated timestamps, the status of each archive operation, customizing table columns, and applying filters to view the desired information. **To view the smart archiving policy runs:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Runs** tab, under **Runs**, locate the **Run Id** you want to learn about it. In this list, you can review a comprehensive history of executed archive policies, including the start time, number and physical size of archived items, and run status. The list is sorted chronologically, with the most recent run at the top. For more information on run statuses, see the following table. 4. To view a report on a specific policy run, locate the run, and then click **Report** icon. A zip file will be downloaded containing one **.csv** files. If the report is for a dry run, it will show the items that would be archived in a real run. If it’s for an actual archive run, it will detail what was archived. ### **Note** - Reports are created and stored in a dedicated repository called `jfrog-policy-reports-local`. We recommend not deleting this repository to maintain a history of policy executions and their results. Deleting it will result in the loss of this history. - If no packages are archived (for a real run) or archived (for a dry run), a report will not be generated. - The number of previous runs included in the history is defined by the artifactory.policy.cleanup.nodes_cleaned.expiration.days system property. HC_ViewAllArchiveRuns.png ### Archive Runs Table Fields The following table describes the columns of the archive runs table fields.
Field Description
**Run ID** Indicates the number of the run id.
**Global** Indicates the policy is applicable at the global level. **Note**: Global Policy may affect multiple projects. It can be managed by a Platform Admin on the Global Scope only.
**Project** Indicates the name of the project.
**Policy Name** Indicates the name of the policy.
**Start Time** Indicates the date and time when the archive operation started running.
**Archived Items (Physical Size)** The number of total archived items, and the total items (The archived size).
**Status**

Indicates the status of each policy execution, which can be one of the following:

Last Run Status
    -8a43-85dc-6fe9663c1ac3.png" width="20" height="20" /> -8a43-85dc-6fe9663c1ac3.png" width="20" height="20" /> -55c1-bcd4-da615b12c40c.png" width="20" height="20" /> the logs for details. -475d-68ac-833a2f186f44.png" width="20" height="20" /> -406e-f32c-408adbae1faf.png" width="20" height="20" /> -475d-68ac-833a2f186f44.png" width="20" height="20" /> -2934-3635-794c718ff632.png" width="20" height="20" /> -2934-3635-794c718ff632.png" width="20" height="20" /> -4db1-fb97-780e9e8a094c.png" width="20" height="20" />
**Report**

Indicates the report download state as follows:

    available for download. icon is clicked. not available.
### Customize Table Columns Arrange the table columns according to how you want to view them. **To display and arrange the columns:** 1. From the Table header, click **Customize Columns** icon at the end. 2. Select which columns to display in the Customize Columns pop-up and drag and drop to reorder them. 3. Click **Apply**. ![HC\_ViewAllRunsCustomizeColumns.png](https://files.readme.io/67c91f05e287a08a762091478c97a2c37ac6f120da4a3ae5e6e6fb9757c8d402-uuid-d068d560-e3f0-e8d6-ae2d-4a1479c14235.png) ### Apply Filters to Sort Run Results You can apply the filter to the run results to easily access your desired view. **To apply filters:** 1. Click the **Filter** icon in the top-right corner of the table header. 2. Apply the following fields as you want to sort: | Name | Description | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Policy Name** | Enter the name of the policy and choose the policy from the list | | **Project** | Enter the name of the project and choose the project from the list | | **Start Time** | Select from the dropdown list or customize the time range using the calendar | | **Status** | Select the run status from the available list. For more information on statuses, see [Archive Runs Table Fields](/docs/archive#archive-runs-table-fields) and the **Status** field. | | **Other** | Select the available options as applicable | 3. To remove applied filters, click **Clear all**. ![HC\_ViewAllRunsFilters.png](https://files.readme.io/f519dc01fe747ba782100595ba68362a72bb3cbc25dba014a900de36201967bd-uuid-cef4a267-2ae0-4cb1-3108-8b12f7decd05.png) ### Refresh Archive Runs If you don't see the latest created runs in the list, you can refresh the runs to view them. To refresh runs, click the **Refresh** icon in the top-right corner of the table header. HC_ViewAllRunsRefresh.png #### Stop All Smart Archiving Policy Runs This topic outlines how to stop all smart archiving policy runs. You can perform this action from the policies tab and runs tab. As a Platform Admin, you can stop all currently running policies. Once a policy run is stopped, it cannot resume from its last point. You must restart the policy from the beginning to rerun it. ### **Note** The option to stop all running policies is not available to Project Admins. The **Stop All Runs** option can be viewed in the global context only. **To stop all the smart archiving policy runs:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Policies** tab, click **Global Stop/Disable**, and then click **Stop All Runs**. To verify that all runs have stopped, under the **Policies** tab, check the **Last Run Status** column to ensure that all runs have stopped. HC_ViewAllPoliciesStopAllRuns.png #### Download and Review Smart Archiving Run Report This section outlines how to download a smart archiving run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the archived packages. ### **Note** The report is generated for both actual runs and dry runs. **To download the smart archiving run report:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. On the **Retention Policies** page, click **Archive**. 3. From the **Runs** tab, under **Runs**, locate the run for which you want to download the report, and then click the **Download** icon. HC_ViewAllRunsDownloadRunReport.png A zip file is downloaded that includes a **.csv** file. 4. Review the downloaded report. For more information, see [Smart Archiving Run Report Overview](#smart-archiving-run-report-overview "Smart Archiving Run Report Overview"). #### Smart Archiving Run Report Overview The downloaded CSV report provides a detailed summary of the archive process, including information on the policy used, the status of the run, and the packages processed. The following are available in the archive report:
Field Description
**Run General Details** The general details of the archive run.
archive run for `` `` The policy name and current status of the archive run.
isDryRun Indicates whether the run was a dry run or an actual run: - **True**: Dry run (no changes made). - **False**: Actual run (changes applied).
Run Start Time The timestamp when the archive process started.
Duration The total time taken for the archive process.
**Run Summary** The summary of the archive run.
Archive packages count The total number of packages successfully archived.
Total packages count The total number of packages processed during the archive.
Packages virtual size The virtual size of all archived packages.
Packages physical size The actual physical size of all archived packages.
**Policy Configuration For This Run** Indicates the configuration details of the policy.
Policy Key The name of the archive policy used for this run.
Description A description of the archive policy.
Cron Expression The cron expression used to schedule the archive runs.
Max Run Duration The maximum duration allowed for the policy to run.
Skip Trash Can Indicates if the trash can was skipped during the archive: - **Enabled**: Trash can is skipped. - **Disabled**: Trash can is not skipped.
Created By The user who created the policy.
Creation Time The timestamp when the policy was created.
Last Modified By The user who last edited the policy.
Last Modification Time The timestamp when the policy was last edited.
Projects The project name associated with the policy.
Included in Projects The projects to which the policy is assigned.
Package Types Indicates which projects the Global policy applies to. It includes: **All**: This option indicates that the policy is shared with all projects. This is selected when the **Include All Projects** checkbox is checked in the policy settings. **N/A**: This option indicates that the policy is not applicable to any specific projects.
Included in Repositories The repositories included in the policy.
Excluded from Repositories The repositories not affected by the policy.
Include Package Name Pattern The name pattern applied to select packages for archiving.
Exclude Package Name The name pattern applied to exclude packages from archiving.
Age Condition (older than) The age-based condition for selecting packages (for example, older than a specified time).
Usage Condition (not downloaded since) The condition for selecting packages based on usage (for example, not downloaded since a certain date).
Version (keep last N) The number of latest versions to retain. Older versions are archived.
**Run Detailed Summary**

Indicates the detailed archive run summary:

  • Package name: The name of the archived package.
  • Version: The version of the archived package.

    **Note** For **Generic** packages or any other package types without version information, the system uses the package creation time (epoch timestamp) as the version.

  • Size: The size of the package on the disk.
  • Repository: The repository from which the package was archived.
  • Repository Type: The type of the repository (For example, Local, Federated).
  • Status: The status of the archive operation (For example, Archived).
  • Status message: A brief message indicating the result of the archive operation. If the package was skipped, the message provides the reason why (for example, the package has been modified since it was archived or has already been restored).
  • Package path: The full path to the package location.
  • Created date: The timestamp when the package was created.
  • Modified date: The timestamp when the package was last edited.
  • Last Downloaded date: The timestamp when the package was last downloaded.
### Search and Restore Archived Packages This section outlines the actions you can perform on the global search bar from the Active Artifactory Instance. It includes searching and restoring archived packages. ![Archive\_Search\_and\_Restore.png](https://files.readme.io/889303f850152ec1ab4320e4de0ac524f9ad68f76073b951982891fe9c1a2586-uuid-14c4bf91-89da-5cb7-35f1-3e4f2ecc106d.png)
Task Description For UI, see... For API, see...
**Search Archived Packages** This topic outlines how to search archived packages. Perform a dedicated search for archived packages in the Active Artifactory Instance. The search results indicate the original repository of each package found. [Search Archived Packages](#search-archived-packages "Search Archived Packages") [Search for Archived Packages](/docs/archive#search-for-archived-packages)
**Restore Archived Packages** Restore is a non-destructive process, ensuring that none of the restored packages are deleted from the Archive Artifactory Instance. ### **Note** Restore is a non-destructive process, ensuring that none of the restored packages are deleted from the Archive Artifactory Instance. [Restore Archived Packages](#restore-archived-packages "Restore Archived Packages") [Restore Archived Packages API](/reference/restorearchivedpackages)
### Authorization
Activity Platform Admin Project Admin **Note:** Available from Version 7.123. Application User
[Search Archived Packages](#search-archived-packages) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Restore Archived Packages](#restore-archived-packages "Restore Archived Packages") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
#### Search Archived Packages This topic outlines how to search archived packages. Perform a dedicated search for archived packages in the Active Artifactory Instance. The search results indicate the original repository of each package found. ### Authorizations
Context Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
**Global Context** ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
**Project Context** ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
**To search the archived packages:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. Click **Archive** from the **Search** dropdown list. 3. Do one of the following: * [Free-Text Search](/artifactory/docs/supported-search-methods#free-text-search) Enter the**pkgType:** as ``, and then click **Search** icon. ![HC\_ArchiveBasicSearch.png](https://files.readme.io/c0cd2a3260b8fe129cfa33509f1e220a9b00a31cc0d16c3776046ff2c31cbbfc-uuid-d1ab5775-fbf1-aeeb-484b-ddbe0a42e8f2.png) * **Advanced Search** 1. Click **Filter** icon at the right end of the **Search** field. The search dropdown window appears. In the search dropdown window, ensure that **Packages** is selected in the upper-right section of the window. 2. Enter search criteria for archived packages, as described in the following table. | Field | Description | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------- | | **Original Repository** | Search for packages based on the original repository name. Wildcard characters are supported. | | **Archiving Time** | Search for all packages archived within the specified time period. | | **Package Name Pattern** | Search for packages based on the name pattern. Wildcard characters are supported. | | **Package version** | If you want to search for a specific package version, enter the version number here. Wildcard characters are supported. | | **Package Type** | Select the package type that you want to search for. | 3. After entering the search criteria, click **Search** to display results. ![HC\_ArchiveSearch2.png](https://files.readme.io/0094f4e3f823dddce12ea965d4f3f0b4773608db771ea5c6a148a7e8d0da9c3d-uuid-1946f1c1-3d8e-2bc4-3950-52689083695c.png) ### Customize Table Columns Arrange the table columns according to how you want to view them. **To display and arrange the columns:** 1. From the Table header, click **Customize Columns** icon at the end. 2. Select which columns to display in the Customize Columns pop-up. 3. Click **Apply**. HC_SearchCustomizeColumns.png #### Restore Archived Packages Restore is a non-destructive process, ensuring that none of the restored packages are deleted from the Archive Artifactory Instance. ### **Note** Restore is a non-destructive process, ensuring that none of the restored packages are deleted from the Archive Artifactory Instance. **To restore the archived packages, follow these steps:** 1. [Search Archived Packages](#search-archived-packages "Search Archived Packages") 2. From the list of **Search Archived Packages** results, do one of the following: The following table describes the criteria for Original Location and New Location.
Field Description
**Original Location** Restore to the original repository where the items were located before archiving.
**Fallback Location** If the Original Location is selected, it is mandatory to provide a Fallback Location. If the Original Location no longer exists, the Fallback Location is used as the location for restoring packages. ### **Note** - Before providing the Fallback Location, ensure that the path already exists. - If you are restoring packages, we recommend assigning a Fallback Location that is the same package type as the restored package.
**New Location** Restore to a new location. ### **Note** - Before providing the New Location, ensure that the path already exists. - If you are restoring packages, JFrog recommends assigning a New Location that is the same package type as the restored package.
* **Single Package Restoration** 1. Locate the package you want to restore, and then click **Restore** icon. 2. Select **Original Location** or **New Location**, enter the repository name, and then click **Restore**. ![HC\_Restore1.png](https://files.readme.io/b40f91c84e49a4922846d891d94be7449ad446fa7f5e025a6790365a801a4458-uuid-f91b3eab-d6b1-b21f-9b3f-8604f2411918.png) * **Multiple Package Restoration** 1. Select the checkbox in line with the packages you want to restore, and then click **Restore**. 2. Select **Original Location** or **New Location**, enter the repository name, and then click **Restore**. ![HC\_Restore2.png](https://files.readme.io/1fccedeebd0a75724fd27f99f9c7fb27ceada6fd3bc52eb893ce7fd20e260b26-uuid-2b6b71ad-64e1-2f09-20c3-343bbb3a3a44.png) ### **Note** - The restoration process duration depends on the number and size of the packages, ranging from a few minutes to several hours. - If an error occurs during the restoration, the process will fail, and the error details will be logged. - The default maximum number of artifacts that can be restored in a single run is 10,000. ### **Note** If the number of artifacts (across selected packages) exceeds 10,000  limit, the restore process terminates (Restoration does not happen). The reason for termination will be logged. Carry out the restore operation again and make sure that the number of artifacts are less than the defined limit. ### Manage Restore Runs This section outlines the actions you can perform on the Restore Runs from the Active Artifactory Instance. It includes view, stop all runs and downloading run reports.
Task Description For UI, see... For API, see...
**View All Restore Runs** This topic outlines how to view the status of both past and ongoing restore runs. It provides guidance on how to review specific details, including the items that have been restored, the associated timestamps, the status of each restoration operation, customizing table columns, and applying filters to view the desired information. [View All Restore Runs](#view-all-restore-runs "View All Restore Runs") NA
**Download and Review Restore Run Report** This topic outlines how to download a restore run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the restored packages. [Download and Review Restore Run Report](#download-and-review-restore-run-report "Download and Review Restore Run Report") [Restore Run Report Overview](#restore-run-report-overview "Restore Run Report Overview") NA
### Authorization
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[View All Restore Runs](#view-all-restore-runs "View All Restore Runs") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Download and Review Restore Run Report](#download-and-review-restore-run-report "Download and Review Restore Run Report") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
#### View All Restore Runs This topic outlines how to view the status of both past and ongoing restore runs. It provides guidance on how to review specific details, including the items that have been restored, the associated timestamps, the status of each restoration operation, customizing table columns, and applying filters to view the desired information. **To view restore runs:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. Click **Restored** tab. HC_ViewRestoreRuns.png The restored runs list is displayed. ### Restore Table Fields The following table describes the columns of the restore table fields.
Field Description
**Run ID** Indicates the number of the run id.
**Project** Indicates the name of the project.
**Start Time** Indicates the date and time when the restore operation started running.
**Restored Items (Physical Size)** The number of total restored items, and the total items (The restored size).
**Status**

Indicates the status of each restore execution, which can be one of the following:

Restore Run Status
    e logs for details.
**Report**

Indicates the report download state as follows:

Possible Download States
### Customize Table Columns Arrange the table columns according to how you want to view them. **To display and arrange the columns:** 1. From the Table header, click **Customize Columns** icon at the end. 2. Select which columns to display in the Customize Columns pop-up. 3. Click **Apply**. HC_RestoreRunsCustomizeColumns.png ### Apply Filters to Sort Run Results You can apply the filter to the run results to easily access your desired view. **To apply filters:** 1. Click the **Filter** icon in the top-right corner of the table header. 2. Apply the following fields as you want to sort: | Name | Description | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Run ID** | Enter run id | | **Start Time** | Select from the dropdown list or customize the time range using the calendar | | **Status** | Select the run status from the available list. For more information on statuses, see [Restore Table Fields](/docs/archive#restore-table-fields) and the **Status** field. | 3. To remove applied filters, click **Clear all**. ![HC\_RestoreRunsFilters.png](https://files.readme.io/dd1884aaaebee425ef3cf0b0f409bc12ae6dc0ccadf7c0ca553a0038132d25be-uuid-2f5009fd-cd6f-6608-463d-a97376241dc6.png) ### Refresh Restore Runs If you don't see the latest created runs in the list, you can refresh the runs to view them. To refresh runs, click the **Refresh** icon in the top-right corner of the table header. ![HC\_RestoreRunsRefresh.png](https://files.readme.io/4c1e933788f7c65f5b6e327b286895a0abbe485357a02daadd8c7a874ca519dd-uuid-2ea55249-7858-1208-0e77-09a884339f09.png) #### Download and Review Restore Run Report This topic outlines how to download a restore run report. The report is in CSV format and lists all archived packages with relevant information. You can review the list to learn about the restored packages. **To download the report:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. 2. In the **Retention Policies** page, click **Archive**. 3. From the **Restored** tab, under **Restored**, locate the run for which you want to download the report, and then click **Download** Icon. HC_RestoreRunsDownloadRunReport.png A zip file is downloaded including one or more **.csv** files. Possible Download icon statuses are as follows: | Icon | State | Description | | :------------------------------------------------------------------------------------------------------------------------------------------ | :------- | :--------------------------------------------- | | ![](https://files.readme.io/882a30678a19872071700d0d8cfcc3dd4fbe5a90a01f638b0ec6554a10824e71-uuid-6728ae0b-8774-c6fa-2020-7c7db4531bd3.png) | Enabled | Indicates the report is available for download | | ![](https://files.readme.io/537f3cb21c34c341d51e63740e18cef96f8c4b2c473b1ebbacf075ba63ee19a5-uuid-ecac4f7d-d12f-8871-83af-0fddeded681e.png) | Hover | On hovering the mouse pointer | | ![](https://files.readme.io/c28aeed83dd0aa0d494d5b7e5859f5485c4906f6b1a62e640e39495a07de0b4f-uuid-31c9b012-21b7-0e40-3637-0c2fa131b89b.png) | Selected | Indicates the download icon is clicked | | ![](https://files.readme.io/38f29758370b5387c39a47db17f90433a0c96560ed08da19c183d36a134ff2a1-uuid-bf918354-f2f6-e520-20e8-11dd25feb09f.png) | Disabled | Indicates the report is not available | ### Restore Run Report Overview The downloaded CSV Restore Run Report provides a detailed summary of a package restoration process. It includes key information about the restoration status, runtime details, and the packages processed.
Field Description
**Run General Details** The general details of the restore run.
Restore run `` The current status of the restore operation.
Run Start Time The timestamp when the restore process started.
Duration The total time taken for the restore process to complete.
**Run Summary** The summary of the restore run.
Restored packages count The total number of packages successfully restored.
Total packages count The total number of packages processed during the restore.
Packages virtual size The virtual size of all restored packages.
Packages physical size The actual physical size of all restored packages.
**Restoration Query For This Run** Indicates the query executed for this restore.
Origin Projects The source project names from which the packages were restored.
Package Type The types of packages selected for restoration.
Fallback Destination Path The original destination path used for restoring the packages.
New Destination Path The new destination path where the packages were restored.
Restore to Original Indicates whether the restoration was to the original repository from which the package was archived.
**Run Detailed Summary**

Indicates the detailed restore run summary.

    he restored package. restored package. h for the lead artifact (if applicable). ge on the disk. sitory from which the package was archived. type of the source repository (For example, Local, Federated). repository to which the package was restored. estoration (For example, Restored). sage indicating the result of the restore operation. to the package location. when the package was created. p when the package was last edited.
## Monitor Smart Archiving and Restore This section outlines monitoring archive storage, archive and restore runs. | Task | Description | For UI, see... | For API, see... | | :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- | :-------------- | | Monitor Smart Archiving Storage Info | This topic outlines how to view Archive Storage Info and provides guidance on detailed insights into optimization after successful archival. | [Monitor Smart Archiving Storage Info](#monitor-smart-archiving-storage-info "Monitor Smart Archiving Storage Info") | NA | | Monitor Smart Archiving and Restore via UI and Logs | This topic outlines how to monitor archive and restore runs from the UI and their logs. | [Monitor Smart Archiving and Restore - via UI and Logs](#monitor-smart-archiving-and-restore---via-ui-and-logs) | NA | ### Authorization
Activity Platform Admin Project Admin **Note:** Applicable within the scope of your project context. Application User
[Monitor Smart Archiving Storage Info](#monitor-smart-archiving-storage-info "Monitor Smart Archiving Storage Info") ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) **Note:** This option is shown from the Global Context only. ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
[Monitor Smart Archiving and Restore - via UI and Logs](#monitor-smart-archiving-and-restore---via-ui-and-logs) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/a98b695e451b8d5fb66163e9e59a92d5ed9f4d3216251fe805b8694bf5287195-uuid-21af6040-6bb8-7176-7b43-e885d80cc0e2.svg) ![](https://files.readme.io/30c2518e9c011116c0fbfc7975b9de0dec2d95371dc2bf54b054d339af4405c2-uuid-743a6924-5713-3f27-4a63-b66e1c78bfa8.svg)
### Monitor Smart Archiving Storage Info This topic outlines how to view Archive Storage Info and provides guidance on detailed insights into optimization after successful archival. **To view the Archive Storage info:** 1. From the **Administration** module, select **Artifactory > Retention Policies**. ### **Note** The **Archive Storage Info** can be viewed in the global context only. 2. In the **Retention Policies** page, click **Archive**. 3. Click any of the following tabs, and then click **Archive Storage Info** link from the top right of the page. * Policies * Runs * Restored 4. The Archive Storage info provides the following details: ![HC\_ViewArchiveStorageInfo1.png](https://files.readme.io/cadf96a9b0b3510a42301b02a22eda96b43b4ac3b29f4f95a15661d3080563a0-uuid-fd215a44-9cd1-9352-57d6-617d0410f52f.png)
Field Description
**Archive Storage** Total archive size For example, 750 GB
**Optimization** Percentage of optimization (space saved) after archiving binaries and artifacts. For example: - Initial Storage - 1000 GB - Archived - 750 GB **Optimization** = ((Initial Storage - Archive)/Initial Storage)) X 100 = 25% **Example:** **Optimization** = ((1000 - 750)/1000)) X 100 = 25% The archiving process saved 25% of the original storage space.
**Virtual** Total size on disk of artifacts without optimization. For example, 200 artifacts, 1000 GB
**Physical** Total size on disk of binaries with optimization. For example, 50 binaries, 750 GB
### Monitor Smart Archiving and Restore - via UI and Logs This topic outlines how to monitor archive and restore runs from the UI and their logs. **To monitor archive and restore, in the Active Artifactory Instance:** * **From the platform UI** After initiating an archive or restore operation, you can monitor its progress and view the status of archive and restore operations from the respective runs. * [View All Smart Archiving Runs](#view-all-smart-archiving-runs "View All Smart Archiving Runs") * [View All Restore Runs](#view-all-restore-runs "View All Restore Runs") * **From Artifactory Logs** ### **Note** Applies to Platform Admin only. 1. From the **Projects** dropdown list, click **All Projects**. 2. From the **Administrator** module, select **Monitoring > Artifactory Logs**. The **Artifactory Logs** page appears. HC_ArchiveLogs.png 3. From the **View System Logs** dropdown list, select **artifactory-service.log**. 4. View the logs. ## Related Topics * [Retention Policies](/docs/retention-policies) * [Cleanup Policies](/docs/cleanup-policies) * [Manage Platform Deployments](/docs/manage-platform-deployments) * [Stages Lifecycle](/docs/stages-lifecycle) * [Log Files Location and Naming](/docs/log-files-location-and-naming)