Using the latest version?
JFrog Container Registry Guide
Setting up JFrog Container Registry to Use S3
First time installation or upgrade
If you are moving your filestore to S3 in the context of upgrading JFrog Container Registry, or a first time installation, we recommend that you first do a standard installation of JFrog Container Registry using the default settings, or a standard upgrade using your current settings.
In order to move your JFrog Container Registry filestore to the cloud, you need to execute the following steps:
- Shut down JFrog Container Registry.
- Configure JFrog Container Registry to use your S3 object storage provider
- Migrate your files to the cloud manually or automatically
- Start up JFrog Container Registry
Setting Your License
To use an S3 object store, your JFrog Container Registry installation needs to be activated with an Enterprise license.
Configuring JFrog Container Registry to Use S3
JFrog Container Registry's filestore is configured through the
binarystore.xml file. For details, please refer to Configuring the Filestore.
Migrating Your Filestore from local/mounted storage to S3
There are two ways to migrate your filestore over to your S3 provider.
Automatic Filestore Migration (Recommended)
To make sure your filestore migration completes successfully without corrupting files, we recommend configuring JFrog Container Registry to do this migration for you automatically:
To do so, you need to create the following links in
$ARTIFACTORY_HOME/data/eventual/ (create it if the
eventual folder does not exist - it is created automatically when the eventual binary provider is applied via an JFrog Container Registry restart with an updated binarystore.xml):
- A link with the name
_addthat points to the
- A link with the name _pre that points to the
With this setting, as soon as JFrog Container Registry starts up, it will automatically move your complete filestore over to your S3 provider.
Your current filestore will be deleted
The process of moving your filestore to your S3 provider will delete your current filestore. We strongly recommend you do a complete system backup before doing this migration.
Once the migration is complete, you may delete the _pre link and the
Manual Filestore Migration
To migrate your filestore manually, you need to execute the following steps:
- Stop JFrog Container Registry
- Copy the
$ARTIFACTORY_HOME/data/filestoredirectory to your S3 object storage to the bucket name and path specified when you configured JFrog Container Registry to use S3.
- Start JFrog Container Registry
Server Side Encryption Support
JFrog Container Registry supports SSE-KMS. You can configure JFrog Container Registry to work against an S3 bucket that is configured with Server Side Encryption.
To set up JFrog Container Registry to work with against an S3 bucket configured with KMS, add the following line to the bintraystore.xml file:
<property name="s3service.server-side-encryption" value="aws:kms"></property>