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.
Operational Flow¶
-
User Request
- A user initiates a file download (system image, package, etc.) from Armbian using a standard URL (e.g.,
https://dl.armbian.com
).
- A user initiates a file download (system image, package, etc.) from Armbian using a standard URL (e.g.,
-
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
- The redirector server processes the request and determines the best available mirror based on:
-
Mirror Assignment
- The redirector server provides a direct URL to the most suitable mirror.
- The user is automatically redirected to the designated server.
-
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 | ![]() |
2500 Mbps | ||||
Auroradev Chicago | America/Chicago | ![]() |
1000 Mbps | ||||
Auroradev Las Vegas | America/Los_Angeles | ![]() |
10000 Mbps | ||||
Nardol | Europe/Paris | ![]() |
1000 Mbps | ||||
Systemonachip | Europe/Vienna | ![]() |
1000 Mbps | ||||
TNA Hosting | America/New_York | ![]() |
1000 Mbps | ||||
Naho.moe Australia | Australia/Sydney | ![]() |
10000 Mbps | ||||
SBC mirror Australia | Australia/Sydney | ![]() |
1000 Mbps | ||||
Naho.moe Germany | Europe/Berlin | ![]() |
1000 Mbps | ||||
SBC mirror Spain | Europe/Madrid | ![]() |
1000 Mbps | ||||
Fast Mirror | Europe/Kiev | ![]() |
1000 Mbps | ||||
Hetzner Germany | Europe/Berlin | ![]() |
1000 Mbps | ||||
Imola | Europe/Ljubljana | ![]() |
1000 Mbps | ||||
Naho.noe India | Asia/Kolkata | ![]() |
1000 Mbps | ||||
Naho.moe Japan | Asia/Tokyo | ![]() |
10000 Mbps | ||||
Naho.moe Korea | Asia/Seoul | ![]() |
1000 Mbps | ||||
Kspace Estonia | Europe/Tallinn | ![]() |
10000 Mbps | ||||
Albony | Asia/Kolkata | ![]() |
1000 Mbps | ||||
Macarne LLC | Europe/Amsterdam | ![]() |
50000 Mbps | ||||
SteeMan | America/Chicago | ![]() |
1000 Mbps | ||||
Airframes Europe | Europe/Berlin | ![]() |
1000 Mbps | ||||
Hostiko | Europe/Kiev | ![]() |
20000 Mbps | ||||
ISCAS | Asia/Shanghai | ![]() |
10000 Mbps | ||||
OSS Planet | Asia/Taipei | ![]() |
1000 Mbps | ||||
Alibaba Mirrors | Asia/Shanghai | ![]() |
10000 Mbps | ||||
BFSU | Asia/Shanghai | ![]() |
10000 Mbps | ||||
dotsrc.org | Europe/Copenhagen | ![]() |
20000 Mbps | ||||
Jevin Canders LLC | America/New_York | ![]() |
10000 Mbps | ||||
SJTU | Asia/Shanghai | ![]() |
10000 Mbps | ||||
Nanjing University | Asia/Shanghai | ![]() |
10000 Mbps | ||||
Shanghai Tech University | Asia/Shanghai | ![]() |
10000 Mbps | ||||
SUSTech | Asia/Shanghai | ![]() |
10000 Mbps | ||||
Tsinghua University | Asia/Shanghai | ![]() |
10000 Mbps | ||||
USTC | Asia/Shanghai | ![]() |
10000 Mbps | ||||
xTom | Europe/Berlin | ![]() |
10000 Mbps | ||||
Digital Streaming Co. | Asia/Taipei | ![]() |
50000 Mbps | ||||
Airframes Phoenix | America/Phoenix | ![]() |
1000 Mbps | ||||
Airframes Seattle | America/Los_Angeles | ![]() |
1000 Mbps | ||||
Airframes Seattle | America/Los_Angeles | ![]() |
1000 Mbps | ||||
Airframes St Louis | America/Chicago | ![]() |
1000 Mbps | ||||
VineHost.NET | Europe/London | ![]() |
1000 Mbps | ||||
Yandex | Europe/Moscow | ![]() |
10000 Mbps | ||||
Netcup Germany | Europe/Berlin | ![]() |
2500 Mbps | ||||
Netcup Germany | Europe/Berlin | ![]() |
2500 Mbps | ||||
Netcup Germany | Europe/Berlin | ![]() |
2500 Mbps | ||||
Netcup Germany | Europe/Berlin | ![]() |
2500 Mbps | ||||
Jing Rocks | Asia/Tokyo | ![]() |
10000 Mbps | ||||
Naho.moe Singapore | Asia/Singapore | ![]() |
1000 Mbps | ||||
SBC mirror Singapore | Asia/Singapore | ![]() |
1000 Mbps | ||||
JetHome | Europe/Moscow | ![]() |
2000 Mbps | ||||
Naho.moe UK | Europe/London | ![]() |
1000 Mbps | ||||
Naho.noe USA west | America/New_York | ![]() |
1000 Mbps | ||||
Xogium | Europe/Paris | ![]() |
500 Mbps |