Here’s a comprehensive, step-by-step tutorial for migrating or configuring JFrog Artifactory 7.117.7+ (self-hosted, Linux) to use AWS EFS (Elastic File System) as its filestore. This guide brings together all best practices from JFrog documentation, AWS, and real-world experience.
(Suitable for both single-node and HA Artifactory setups.)

🟢 JFrog Artifactory 7.117.7+ with AWS EFS: Step-by-Step Guide

Step 1: Prepare Your AWS EFS

• Create an EFS File System in the AWS Console.
• Create Mount Targets for each AZ where your Artifactory servers run.
• Set security group rules: Allow NFS (port 2049) inbound from your EC2(s).
• Note your EFS DNS name (looks like fs-xxxx.efs.<region>.amazonaws.com).

Step 2: Mount EFS on Your Artifactory Server(s)

1. Install NFS Client: sudo apt update && sudo apt install -y nfs-common # Ubuntu/Debian # OR sudo yum install -y nfs-utils # RHEL/CentOS/Amazon Linux
2. Create a Mount Directory: sudo mkdir -p /mnt/efs
3. Mount EFS: sudo mount -t nfs4 -o nfsvers=4.1 fs-xxxx.efs.<region>.amazonaws.com:/ /mnt/efs (Replace fs-xxxx... with your EFS DNS name.)
4. Add to /etc/fstab for Persistent Mount: fs-xxxx.efs.<region>.amazonaws.com:/ /mnt/efs nfs4 defaults,_netdev 0 0

Step 3: (Optional) Copy Existing Filestore Data

If migrating existing artifacts:

1. Stop Artifactory: sudo systemctl stop artifactory
2. Copy data to EFS: sudo cp -a /opt/jfrog/artifactory/var/data/artifactory/filestore/* /mnt/efs/ (Use rsync -av for large data or HA setups.)

Step 4: Configure Artifactory to Use EFS

1. Edit the binarystore.xml file: sudo vi /opt/jfrog/artifactory/var/etc/artifactory/binarystore.xml
2. Replace the content with: <config version="2"> <chain template="file-system"/> <provider id="file-system" type="file-system"> <fileStoreDir>/mnt/efs</fileStoreDir> </provider> </config> If you used a subdir, use /mnt/efs/filestore above and adjust the copy commands accordingly.

Step 5: Fix Permissions

sudo chown -R artifactory:artifactory /mnt/efs

(Repeat for /mnt/efs/filestore if using a subdirectory.)

Step 6: Start Artifactory

sudo systemctl start artifactory
sudo systemctl status artifactory

Step 7: Verify

• Check UI: Log in to http://<server-ip>:8082
• Upload or download artifacts to confirm they are now stored in EFS (check files appear in /mnt/efs).

Additional Best Practices & Notes

• For HA: All Artifactory nodes must mount EFS to the exact same path and share the same binarystore.xml.
• Always backup your filestore and database before making changes.
• Use NFSv4 (EFS default) for full compatibility.
• Monitor EFS performance—provision throughput if needed for high load.
• For Kubernetes: Use Artifactory’s Helm chart and set artifactory.persistence.type=file-system, then map your PVC to EFS.

Quick Reference Table

References

• Official: Advanced Storage Options
• Official: Filestore Configuration
• Best Practices for Artifactory Filestore (JFrog Whitepaper)

Rajesh Kumar

I’m Rajesh Kumar, a DevOps, SRE, DevSecOps, Cloud, and Platform Engineering expert passionate about sharing practical knowledge, real-world experiences, and industry best practices. I have worked at Cotocus and regularly write about technology, travel, investing, health, product reviews, and digital marketing through my various platforms.

I publish technical articles at DevOps School, travel stories at Holiday Landmark, stock market insights at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at TrueReviewNow, and SEO and digital marketing strategies at Wizbrand.