Mirrors

​

Creating a mirror

1. Select Channels from the left-hand navigation.
2. Create or select a channel to contain your mirror.
   For more information about creating channels, see Creating Channels.
3. Open the channel actions dropdown and Freeze your channel.
   For more information on freezing and unfreezing a channel, see Managing Channels.
4. Open the channel actions dropdown again and select Create Mirror.
5. Complete the Create mirror form. Configuration options differ based on the type of mirror you are creating:
   • Conda
   • Std Python
   • Std R

   

   1

   Mirror Name

   Enter a name for your mirror. Anaconda recommends you name your mirror something descriptive for your end users.

   2

   Mirroring Mode

   Choose whether you want your mirror to be active or passive.Active Mirroring: Downloads packages from the source channel immediately to your local server.

   Some repository channels require a large amount of storage (for example, Anaconda’s public repository is 700GB, conda-forge is 3TB, and PyPI is 10TB), and as a rule, the larger the mirror, the longer the wait time for it to complete.

   Passive Mirroring: Creates a metadata file listing all packages on the mirrored server. Packages are downloaded when users request them via conda install <PKG_NAME>.

   Anaconda recommends establishing your mirrors as passive. Active mirrors take longer to complete than passive mirrors, but regardless of which mirroring mode you choose, the available packages are the same.

   3

   External Source URL

   Enter the URL of the conda channel to mirror.

   Anaconda recommends mirroring from our channels to ensure you have the most up-to-date and secure packages. Create mirrors for the channels that match your users’ platforms and workflows.

   • https://repo.anaconda.cloud/pkgs/main - Packages built for Linux and macOS systems
   • https://repo.anaconda.cloud/pkgs/msys2 - Packages built for Windows systems

   If your external source channel is another Anaconda Platform channel, you must use the format https://<URL>/api/repo/<CHANNEL_NAME>.

   ---

   If your external source channel is another Anaconda Platform channel that contains CRAN R packages, you must use the format https://<URL>/api/repo/<CHANNEL_NAME>/cran.

   ---

   If your external source channel is a virtual channel from Anaconda Platform (Cloud), you must use the format https://repo.anaconda.cloud/repo/t/<TOKEN>/<ORG_ID>/<CHANNEL_NAME>.

   ---

   If your external source channel is one of the Anaconda Channels or Community Package Channels from Anaconda Platform (Cloud), you must use the format https://repo.anaconda.cloud/t/<TOKEN>/repo/<CHANNEL_NAME>.

   ---

   When creating mirrors that use Anaconda Platform (Cloud) channels as the external source, replace <TOKEN> with your individual access token and <ORG_ID> with your organization ID.

   4

   Mirror Type

   Select Conda as the mirror type. This ensures that only conda packages (.conda, .tar.bz2) will be mirrored from the external source channel. Packages in the source channel that are not conda packages are not mirrored.

   5

   Mirroring Frequency

   Set the frequency you want your mirror to run and update your packages. The default value instructs the mirror to update on the first day of every month at midnight Coordinated Universal Time (UTC).Custom frequencies use cron expressions to determine when they run.

   Mirroring large repositories can take several hours. Anaconda recommends against setting a frequency greater than Daily to avoid collisions between currently running and updating mirrors.

   6

   Run Now

   Select this checkbox to start your mirror when you click Save & Run. If the Run Now checkbox is not selected, your changes are saved, and the mirror runs the next time its frequency configuration instructs it to do so.

   7

   Assign Mirror Policy

   Toggle between using the policy that is applied to the channel or selecting a policy to apply to the mirror. For more information about policies, see Policies.

   You cannot apply a policy to a mirror if it is already applied to the channel.

   ---

   Mirror policies override channel policies.

   8

   View Applied Policy

   View details of the policy applied to the mirror.

   9

   Cancel/Save & Run

   Select Cancel at any time to quit your mirror form completion and discard any set parameters. Select Save & Run to start your mirror.
6. Allow the mirror time to complete.
   How do I know when my mirror is complete?

   You can view the status of in-progress mirrors from the from the channel’s Mirrors tab. In-progress mirrors display which step is currently being performed with a brief description of the operation. When a mirror completes, the status updates to Completed and the date and time of completion is displayed.

   
   Administrators can view the status of all mirrors from the Mirrors page.
7. Open the channel actions dropdown and Unfreeze your channel.
   It can take some time for packages to appear in the Packages tab after unfreezing a channel. As a general rule, the larger the repository, the longer the wait.

   ---

   It is not necessary to freeze the channel again once its mirror has completed. The best practice is to freeze the channel, create your mirror, allow it to complete, then unfreeze the channel.

​

Managing mirrors

​

Mirror actions