Skip to content

How the Armbian Mirror System Works

Introduction

The Armbian mirror system is designed to efficiently distribute files, ensuring users get the best available server based on geographic proximity and server availability. This document outlines the mirroring system’s operational flow, technical specifications for mirrors, and how to contribute a new server.

armbian-mirror-explication

Operational Flow

  1. User Request

    • A user initiates a file download (system image, package, etc.) from Armbian using a standard URL (e.g., https://dl.armbian.com).

  2. Redirector Server Processing

    • The redirector server processes the request and determines the best available mirror based on:
      • User’s geographic location
      • Mirror server status and load
      • Availability of the requested files

  3. Mirror Assignment

    • The redirector server provides a direct URL to the most suitable mirror.
    • The user is automatically redirected to the designated server.

  4. Download from Assigned Mirror

    • The user downloads the file directly from the assigned mirror, optimizing speed and reducing load on the main infrastructure.

Benefits of the Mirroring System

  • Load balancing: Requests are distributed across multiple servers to prevent congestion.
  • Faster downloads: Users are served by the closest available mirror.
  • Redundancy and reliability: If a mirror is unavailable, the redirector automatically assigns an alternative.

How to Contribute a Mirror

If you would like to contribute to the Armbian project by providing a mirror, follow these steps:

1. Choose the target and set up an HTTP/HTTPS hostname

- The mirror must be accessible via HTTP, and HTTPS is preferred.

2. Set up synchronization via rsync

- Sync files from one of the official repositories using the following commands:

Content Command Required Space
Current images rsync -av rsync://rsync.armbian.com/dl 556G
Packages rsync -av rsync://rsync.armbian.com/apt 84G
Archived images rsync -av rsync://rsync.armbian.com/archive 1.9T
Very old images rsync -av rsync://rsync.armbian.com/oldarchive 5.4T

- Set up a cron job to sync every 2-4 hours.

3. Inform us about your mirror

- Once your server is configured, contact us via the contact form to integrate it into the official redirector system.

Contributing a mirror helps improve Armbian’s file distribution, ensuring faster and more reliable downloads for the global community.

Current Mirrors

Site Time Zone Flag Speed Packages Images Archive Rsync
Atomo Networks Europe/Rome null 2500 Mbps ✅ ✅ ✅ ✅
Auroradev Chicago America/Chicago East coast 1000 Mbps ✅ ✅
Auroradev Las Vegas America/Los_Angeles West coast 10000 Mbps ✅ ✅ ✅ ✅
Nardol Europe/Paris France 1000 Mbps ✅ ✅
Systemonachip Europe/Vienna Austria 1000 Mbps ✅ ✅ ✅
TNA Hosting America/New_York North America 1000 Mbps ✅ ✅ ✅
SBC mirror Spain Europe/Madrid Spain 1000 Mbps ✅ ✅
Hetzner Germany Europe/Berlin Germany 1000 Mbps ✅ ✅ ✅ ✅
Kspace Estonia Europe/Tallinn Estonia 10000 Mbps ✅ ✅ ✅
AARNet Australia/Sydney Australia 100000 Mbps ✅ ✅
Albony Asia/Kolkata Dynamic 1000 Mbps ✅
Macarne LLC Europe/Amsterdam Netherlands 50000 Mbps ✅ ✅ ✅
Hostiko Europe/Kiev Ukraine 20000 Mbps ✅ ✅
ISCAS Asia/Shanghai China 10000 Mbps ✅ ✅
OSS Planet Asia/Taipei Taiwan 1000 Mbps ✅
Alibaba Mirrors Asia/Shanghai China 10000 Mbps ✅ ✅
BFSU Asia/Shanghai China 10000 Mbps ✅ ✅
c0urier.net Europe/Copenhagen Denmark 1000 Mbps ✅ ✅ ✅
CSTCloud Asia/Shanghai China 10000 Mbps ✅ ✅
dotsrc.org Europe/Copenhagen Denmark 20000 Mbps ✅ ✅
Jevin Canders LLC America/New_York East coast 10000 Mbps ✅ ✅
Lahansons America/Los_Angeles North America 10000 Mbps ✅ ✅
Nanjing University Asia/Shanghai China 10000 Mbps ✅ ✅
Shandong University Asia/Shanghai China 10000 Mbps ✅
Shanghai Tech University Asia/Shanghai China 10000 Mbps ✅ ✅
SUSTech Asia/Shanghai China 10000 Mbps ✅
Tsinghua University Asia/Shanghai China 10000 Mbps ✅ ✅
USTC Asia/Shanghai China 10000 Mbps ✅ ✅
Zhejiang University Asia/Shanghai China 500 Mbps ✅
Digital Streaming Co. Asia/Taipei Taiwan 50000 Mbps ✅ ✅
Airframes St Louis America/Chicago East coast 1000 Mbps ✅ ✅
VineHost.NET Europe/London United Kingdom 1000 Mbps ✅ ✅
Yandex Europe/Moscow Russia 10000 Mbps ✅ ✅
Netcup Germany Europe/Berlin Germany 2500 Mbps ✅ ✅
Netcup Germany Europe/Berlin Germany 2500 Mbps ✅
Netcup Germany Europe/Berlin Germany 2500 Mbps ✅ ✅
JetHome Europe/Moscow Russia 2000 Mbps ✅ ✅ ✅
Xogium Europe/Paris France 500 Mbps ✅ ✅ ✅