S3 Object Storage

JFrog Installation & Setup Documentation


S3 object storage requires JFrog Container Registry, Pro, Enterprise X, or an Enterprise+ license.


The s3-storage template <chain template="s3"/>, which uses JetS3t, is no longer supported as of Artifactory version 7.46.3 and therefore upgrading while using this template will fail. You should use s3-storage-v3 instead, which uses the official Amazon S3 Official SDK. The transition is mostly seamless to v3, since parameters are the same between the two providers. For more information, see here.

Artifactory fully supports S3 object storage for distributed file systems so your Artifactory filestore can reside on the cloud. This presents the following benefits.

  1. Unlimited scalability

    Since your files are now stored on the cloud, this means that your Artifactory filestore is scalable and effectively unlimited (to the extent offered by your storage provider). You may freely continue to upload files without having to install or maintain any file storage devices. You can even upload files larger than 5 GB using multi-part upload.

  2. Security

    Enjoy the same security and authentication mechanisms provided by your S3 provider.

  3. Disaster recovery

    Since your files are replicated and stored with redundancy, this offers the capability for disaster recovery.

  4. Support any S3 compliant protocol

    Artifactory's support is based on the S3 protocol. Any provider that uses S3, such as Ceph, Swift (through the S3 API) and others will also be supported by Artifactory. With support for AWS S3 version 4, you can sign AWS requests using Signature Version 4.

Backup your system. Your current filestore will be deleted.

Setting up Artifactory to use S3 will delete all files in your current filestore.

If you already have a running installation of Artifactory, then before you setup Artifactory to use S3 and migrate your filestore to the cloud, we strongly recommend that you do a complete system backup.Complete System Backup

Filestore Fundamentals

This page provides you with information about a specific binary provider. For more information on filestores and the various filestores that you can use, see Configuring the Filestore.