Contents Menu Expand Light mode Dark mode Auto light/dark mode
Documentation Portal
  • 4.13 (current)
  • 4.0
  • 2.9
  • 3.1 (EOL)
  • 3.0 (EOL)
  • 2.8 (EOL)
Logo
Mirantis Secure Registry
  • Product Overview
  • Reference Architecture
    • Introduction to MSR
    • Components
    • System requirements
    • Networks
    • Volumes
    • Storage
    • MSR Web UI
      • Rule engine
  • Installation Guide
    • System requirements
    • Preconfigure MKE
    • Install MSR online
    • Install MSR offline
    • Obtain the license
    • Uninstall MSR
  • Operations Guide
    • Access MSR
      • Configure your Mirantis Container Runtime
      • Configure your Notary client
      • Use a cache
    • Manage access tokens
    • Configure MSR
      • Add a custom TLS certificate
      • Enable single sign-on
      • Enable read-only mode
      • Disable persistent cookies
      • Disable MSR telemetry
      • Configure external storage
        • Configure MSR image storage
        • Deploy MSR on NFS
        • Configure MSR for S3-compatible cloud storage providers
        • Migrate to a new storage backend
      • Set up high availability
      • Use a load balancer
      • Set up security scanning
        • Enable MSR security scanning
        • Set repository scanning mode
        • Update the CVE scanning database
      • Caches
        • MSR cache prerequisites
        • MSR cache deployment scenario
        • Deploy an MSR cache with Swarm
          • Prepare the cache deployment
          • Deploy the cache
        • Deploy an MSR cache with Kubernetes
          • Prepare the cache deployment
          • Create Kubernetes resources
          • Expose the MSR Cache
        • Configure caches for high availability
        • MSR cache configuration
      • Garbage collection
        • Schedule garbage collection
        • How garbage collection works
      • Create a new repository when pushing an image
      • Use a web proxy
    • Manage applications
    • Manage images
      • Create a repository
      • Review repository information
      • Pull and push images
      • Delete images
      • Scan images for vulnerabilities
        • Security scan process
        • Scan images
        • Review security scan results
        • Override a vulnerability
        • Scanner reporting
      • Prevent tags from being overwritten
      • Sign images
        • Sign images with Cosign
          • Initial local setup
          • Image signing and verification scenarios
          • Sign images that MKE can trust
          • Delete signed images
          • Delete legacy Docker Content Trust
        • Sign images with Docker Content Trust
          • Initial local setup
          • Sign images that MKE can trust
          • Add a delegation
          • Delete trust data
          • Delete signed images
          • Using Docker Content Trust with a Remote MKE Cluster
    • Manage jobs
    • Manage users
    • Manage webhooks
      • Webhook types
      • Manage repository webhooks using web UI
      • Manage repository webhooks using API
        • API curl requests
        • Manage content structure using API
        • View and manage subscriptions
    • Manage repository events
      • Audit repository events
      • Enable Auto-Deletion of Repository Events
    • Promotion policies and monitoring
      • Promotion policies overview
      • Promote an image using policies
      • Mirror images to another registry
      • Mirror images from another registry
      • Template reference
    • Use Helm charts
      • Add a Helm chart repository
      • Pull charts and their provenance files
      • Push charts and their provenance files
      • View charts in a Helm repository
      • Delete charts from a Helm repository
      • Helm chart linting
        • Implement Helm linting
        • Helm chart linting rules
      • Helm limitations
    • Tag pruning
    • Image enforcement policies and monitoring
    • Upgrade MSR
    • Monitor MSR
    • Troubleshoot MSR
    • Disaster recovery
      • Disaster recovery overview
      • Repair a single replica
      • Repair a cluster
      • Create a backup
      • Restore from backup
    • Customer feedback
  • Migration Guide
  • Get Support

Reference documentation

  • API Reference
  • CLI Reference
    • registry.mirantis.com/msr/dtr backup
    • registry.mirantis.com/msr/dtr destroy
    • registry.mirantis.com/msr/dtr emergency-repair
    • registry.mirantis.com/msr/dtr images
    • registry.mirantis.com/msr/dtr install
    • registry.mirantis.com/msr/dtr join
    • registry.mirantis.com/msr/dtr reconfigure
    • registry.mirantis.com/msr/dtr remove
    • registry.mirantis.com/msr/dtr restore
    • registry.mirantis.com/msr/dtr upgrade

Release notes

  • Release Notes
    • 2.10.0
      • New features and enhancements
      • Addressed issues
      • Known issues
      • Major component versions
      • Security information
      • Deprecations
  • Release Compatibility Matrix
    • MSR 2.10 Compatibility Matrix
    • MKE and MSR Browser compatibility
    • MKE, MSR, and MCR Maintenance Lifecycle
  • Release Cadence and Support Lifecycle
  • Open Source Components and Licenses

Configure external storage

By default, MSR uses the local file system of the node where it is running to store your Docker images. You can, though, configure MSR to use an external storage backend, for improved performance or high availability.

  • Configure MSR image storage
  • Deploy MSR on NFS
  • Configure MSR for S3-compatible cloud storage providers
  • Migrate to a new storage backend
Next
Configure MSR image storage
Previous
Disable MSR telemetry
  • Multi-page view
  • Single-page view

Mirantis Inc. 900 E Hamilton Avenue, Suite 650, Campbell, CA 95008 +1-650-963-9828

© 2005 - 2026 Mirantis, Inc. All rights reserved. "Mirantis" and "FUEL" are registered trademarks of Mirantis, Inc. All other trademarks are the property of their respective owners.