OpenWrt software has two distinct branches: a stable **Release** build that is suitable for production use, and a **Development** build that contains an ever-evolving set of enhancements.
OpenWrt software has two distinct branches: a stable **Release** build that is suitable for production use, and a **Development** build that contains an ever-evolving set of enhancements.
| The **Release** builds have had significant testing. Use them for production, or for your home where your family will rely on a functioning router. [[:releases:start|More...]] | Get the latest with a **Development** build. These contain the latest technology, but may not work well, or at all. Be prepared to supply bug reports, etc. [[:releases:snapshot|More...]] |
+
| The **Release** builds have had significant testing. Use them for production, or for your home where your family will rely on a functioning router. [[:releases:start|More...]] | Get the latest with a **Development** build. These contain the latest technology, but may not work well, or at all. Be prepared to supply bug reports, etc. [[:releases:snapshot|More...]] |
===== Download OpenWrt firmware specific for your device =====
===== Download OpenWrt firmware specific for your device =====
Line 19:
Line 19:
===== Build your own firmware =====
===== Build your own firmware =====
-
OpenWrt ships with its own complete build system. You can download and compile your own firmware from source, adding advanced tweaks or modifications that can be done only on build time.
+
OpenWrt ships with its own complete build system. You can download and compile your own firmware from source, adding advanced tweaks or modifications that can be done only at build time.
The OpenWrt build system produces reproducible builds with checksums and Git versioning, all firmware you compile will be exactly the same until you change options or you update OpenWrt sources.
The OpenWrt build system produces reproducible builds with checksums and Git versioning, all firmware you compile will be exactly the same until you change options or you update OpenWrt sources.
Start [[docs:guide-developer:toolchain:start|here]] if you want to compile your own firmware.
Start [[docs:guide-developer:toolchain:start|here]] if you want to compile your own firmware.
Line 48:
Line 48:
Please refer to the list below for alternative locations.
Please refer to the list below for alternative locations.
| **Brazil** | [[http://openwrt.c3sl.ufpr.br/|HTTP]] | [[https://openwrt.c3sl.ufpr.br/|HTTPS]] | - | [[rsync://openwrt.c3sl.ufpr.br/openwrt/]] | [[http://www.ufpr.br/portalufpr/|Universidade Federal do Paraná]] | Only a few releases |
| **Brazil** | [[http://openwrt.c3sl.ufpr.br/|HTTP]] | [[https://openwrt.c3sl.ufpr.br/|HTTPS]] | - | [[rsync://openwrt.c3sl.ufpr.br/openwrt/]] | [[http://www.ufpr.br/portalufpr/|Universidade Federal do Paraná]] | Only a few releases |
-
| **China** | [[http://mirror.sjtu.edu.cn/openwrt/|HTTP]] | [[https://mirror.sjtu.edu.cn/openwrt/|HTTPS]] | - | - | [[https://sjtug.org|Shanghai Jiao Tong University Linux User Group]] | Only releases |
+
| **China** | [[http://mirror.sjtu.edu.cn/openwrt/|HTTP]] | [[https://mirror.sjtu.edu.cn/openwrt/|HTTPS]] | - | - | [[https://sjtug.org|Shanghai Jiao Tong University Linux User Group]] | Only releases |
Please only setup a mirror if really needed: e.g. if you don't have good connectivity to existing mirrors, or if you have many downstream users. In all cases, the official OpenWrt download service won't automatically use your mirror.
Please only setup a mirror if really needed: e.g. if you don't have good connectivity to existing mirrors, or if you have many downstream users. In all cases, the official OpenWrt download service won't automatically use your mirror.
-
Use ''%%rsync://downloads.openwrt.org/downloads%%'' to obtain a copy of the download repository.
+
=== Space requirements ===
-
The current amount of data is 1.6 TB as of November 2022, and it increases by 300-400 GB per year. Snapshots take 150-250 GB, 18.06 releases take 249 GB, 19.07 takes 342 GB, 21.02 takes 454 GB, and 22.03 takes 462 GB so far. You can exclude part of the repository to save space (e.g. ignore snapshots or ignore older releases).
+
The total amount of data is 2.6 TB (2.4 TiB) as of January 2024, and it increases by around 600-700 GB per year. The space needed per release is shown below, in GB = 10^9 bytes. Each number adds up all minor releases for a given major release.
+
+
Feel free to exclude part of the repository to save space (e.g. ignore older releases) or to save bandwidth (e.g. ignore snapshots since they change daily).
Use <del>''%%rsync://downloads.openwrt.org/downloads%%''</del> ''%%rsync://rsync.openwrt.org/downloads%%'' to obtain a copy of the download repository.
+
+
**2023-12-18: We had to change the DNS name for rsync to ''%%rsync.openwrt.org%%'' because ''%%downloads.openwrt.org%%'' is now served by a CDN. Please update your mirror setup to use the new name.**
Due to current bandwidth constraints we kindly ask you to use something like ''%%rsync --bwlimit=8000%%'' when initially pulling the data.
Due to current bandwidth constraints we kindly ask you to use something like ''%%rsync --bwlimit=8000%%'' when initially pulling the data.
Syncing the downloads share every 12 to 24 hours hours is ideal.
Syncing the downloads share every 12 to 24 hours hours is ideal.
+
+
=== Announcing your mirror ===
Once a mirror has been set up, feel free to announce it at ''%%openwrt-adm@lists.openwrt.org%%'', with details about which part of the repository you sync. It will be published on this page, but this is only a convenience so that users can be made aware of available mirrors: there is no automatic load-balancing system that exploits mirrors. Users can choose to manually use a mirror if they find they have a better connectivity to it.
Once a mirror has been set up, feel free to announce it at ''%%openwrt-adm@lists.openwrt.org%%'', with details about which part of the repository you sync. It will be published on this page, but this is only a convenience so that users can be made aware of available mirrors: there is no automatic load-balancing system that exploits mirrors. Users can choose to manually use a mirror if they find they have a better connectivity to it.
-
===== Download statistics =====
-
You can see the [[https://downloads.openwrt.org/stats/|statistics]] for few last months.
-
See the "OpenWrt firmware image downloads" section and by reviewing the link text in the Firmware Image column you can determine most popular router models.