The Parrot Project not only delivers a ready-to-use system in the ISO format, but it also provides a vast amount of additional software that can be installed apart from the official parrot repository.

The Parrot repository is used to provide officially supported software, system updates and security fixes.

The mirrors network

The software in the parrot archive is delivered in form of deb packages, and these packages are served through a vast network of mirror servers that provide the same set of packages distributed all around the world for faster software delivery.

The Parrot system is configured to use the central parrot archive directors. The Parrot directors are special servers that collect all the requests of the end users and redirect them to the geographically nearest download server available for the user who made the request.

If you want and can, you can make your own mirror for Parrot following this procedure.

Security measures

The Parrot Mirror Network is secured by centralized digital signatures and the mirrors can't inject fake updates.

If an evil mirror tries to inject a fake package, the Parrot system will automatically refuse to download and install it, and will raise an alert message.

This security measure implemented in APT (the Parrot/Debian package manager) is very efficient and reliable because digital signatures are applied offline by the Parrot archive maintainer, and not by the mirror servers, ensuring direct and secure developer-to-user chain of trust.

Configuration and custom setup

The APT package manager uses /etc/apt/sources.list and any .list file found in the /etc/apt/sources.list.d/ directory.

Note

/etc/apt/sources.list is EMPTY and the default APT configuration is located at /etc/apt/sources.list.d/parrot.list.

Content of /etc/apt/sources.list.d/parrot.list

deb https://deb.parrot.sh/parrot/ rolling main contrib non-free
#deb-src https://deb.parrot.sh/parrot/ rolling main contrib non-free
deb https://deb.parrot.sh/parrot/ rolling-security main contrib non-free
#deb-src https://deb.parrot.sh/parrot/ rolling-security main contrib non-free

Other mirrors for manual configuration

NCSA

North Central and South Americas

Location
Mirror ID
bandwidth
Provider NameURLAPT config string
Massachussetts
MIT
1 Gbps
SIPB MITmirrors.mit.edu/parrotdeb http://mirrors.mit.edu/parrot/ rolling main contrib non-free
New York
Clarkson
1 Gbps
Clarkson Universitymirror.clarkson.edu/parrotdeb https://mirror.clarkson.edu/parrot/ rolling main contrib non-free
Oregon
Osuosl
1 Gbps
Oregon State University - Open Source Labftp.osuosl.org/pub/parrotosdeb https://ftp.osuosl.org/pub/parrotos rolling main contrib non-free
California
Berkeley
1 Gbps
Berkeley Open Computing Facilitymirrors.ocf.berkeley.edu/parrotdeb https://mirrors.ocf.berkeley.edu/parrot/ rolling main contrib non-free
Virginia
Leaseweb
10 Gbps
Leasewebmirror.wdc1.us.leaseweb.net/parrotdeb https://mirror.wdc1.us.leaseweb.net/parrot rolling main contrib non-free
Ecuador
CEDIA
100 Mbps
RED CEDIA (National research and education center of Ecuador)mirror.cedia.org.ec/parrotdeb https://mirror.cedia.org.ec/parrot/ rolling main contrib non-free
Ecuador
UTA
100 Mbps
UTA (Universidad Técnica de ambato)mirror.uta.edu.ec/parrotdeb https://mirror.uta.edu.ec/parrot/rolling main contrib non-free<
Ecuador
UEB
100 Mbps
UEB (Universidad Estatal de Bolivar)mirror.ueb.edu.ec/parrotdeb https://mirror.ueb.edu.ec/parrot/ rolling main contrib non-free
Brazil
USP
1 Gbps
University of Sao Paulosft.if.usp.br/parrotdeb http://sft.if.usp.br/parrot/ main contrib non-free
Canada
/
/
0xemhttps://mirror.0xem.ma/parrot/deb https://mirror.0xem.ma/parrot/ main contrib non-free

EMEA

Europe Middle East and Asia

Location
Mirror ID
bandwidth
Provider NameURLAPT config string
Italy
GARR
10 Gbps
GARR Consortium (Italian Research & Education Network)parrot.mirror.garr.it/mirrors/parrotdeb https://parrot.mirror.garr.it/mirrors/parrot/ rolling main contrib non-free
Germany
Halifax
20 Gbps
RWTH-Aachen (Halifax students group)ftp.halifax.rwth-aachen.de/parrotsecdeb https://ftp.halifax.rwth-aachen.de/parrotsec/ rolling main contrib non-free
Germany
Esslingen
10 Gbps
Esslingen (University of Applied Sciences)ftp-stud.hs-esslingen.de/pub/Mirrors/archive.parrotsec.orgdeb https://ftp-stud.hs-esslingen.de/pub/Mirrors/archive.parrotsec.org/ rolling main contrib non-free
Germany
Leaseweb
10 Gbps
Leasewebmirror.fra10.de.leaseweb.net/parrotdeb https://mirror.fra10.de.leaseweb.net/parrot rolling main contrib non-free
Germany
pyratelan
/
pyratelanmirror.pyratelan.org/parrotdeb https://mirror.pyratelan.org/parrot rolling main contrib non-free
Netherlands
NLUUG
10 Gbps
Nluugftp.nluug.nl/os/Linux/distr/parrotdeb https://ftp.nluug.nl/os/Linux/distr/parrot/ rolling main contrib non-free
Netherlands
lyrahosting
/
lyrahostingmirror.lyrahosting.com/parrotdeb https://mirror.lyrahosting.com/parrot rolling main contrib non-free
Sweden
UMU
20 Gbps
ACC UMU (Academic Computer Club, Umea University)ftp.acc.umu.se/mirror/parrotsec.org/parrotdeb https://ftp.acc.umu.se/mirror/parrotsec.org/parrot/ rolling main contrib non-free
Greece
UOC
1 Gbps
UoC (University of Crete - Computer Center)ftp.cc.uoc.gr/mirrors/linux/parrotdeb https://ftp.cc.uoc.gr/mirrors/linux/parrot/ rolling main contrib non-free
Belgium
Belnet
10 Gbps
Belnet (The Belgian National Research)ftp.belnet.be/archive.parrotsec.orgdeb http://ftp.belnet.be/mirror/archive.parrotsec.org/ rolling main contrib non-free
Spain
Osluz
1 Gbps
Osluz (Oficina de software libre de la Universidad de Zaragoza)matojo.unizar.es/parrotdeb http://matojo.unizar.es/parrot/ rolling main contrib non-free
Portugal
UP
1 Gbps
U.Porto (University of Porto)mirrors.up.pt/parrotdeb https://mirrors.up.pt/parrot/ rolling main contrib non-free
Denmark
Dotsrc
10 Gbps
Dotsrc (Aalborg university)mirrors.dotsrc.org/parrotdeb https://mirrors.dotsrc.org/parrot/ rolling main contrib non-free
France
Cythin
100 Mbps
Cythin.comparrot.mirror.cythin.com/parrotdeb https://parrot.mirror.cythin.com/parrot rolling main contrib non-free
France
iriseden
/
irisedenparrot-mirror.iriseden.eu/parrotdeb https://parrot-mirror.iriseden.eu/parrot rolling main contrib non-free
Hungary
quantum-mirror
700 Mbps
quantum-mirror.huquantum-mirror.hu/mirrors/pub/parrotdeb https://quantum-mirror.hu/mirrors/pub/parrot rolling main contrib non-free
Turkey
EB
100 Mbps
EBturkey.archive.parrotsec.org/parrotdeb http://turkey.archive.parrotsec.org/parrot/ rolling main contrib non-free
Estonia
cspacehosting
/
cspacehostingmirror.cspacehostings.com/parrotsecdeb https://mirror.cspacehostings.com/parrotsec rolling main contrib non-free
Russia
Yandex
1 Gbps
Yandexmirror.yandex.ru/mirrors/parrotdeb https://mirror.yandex.ru/mirrors/parrot/ rolling main contrib non-free
Russia
Truenetwork
10 Gbps
Truenetworkmirror.truenetwork.ru/parrotdeb https://mirror.truenetwork.ru/parrot/ rolling main contrib non-free
Russia
surf
/
surfmirror.surf/parrotdeb https://mirror.surf/parrot rolling main contrib non-free
Ukraine
comsys
1 Gbps
KPI (National Technical University of Ukraine - Comsys)mirrors.comsys.kpi.ua/parrotonly ISO files are mirrored
Ukraine
astra.in.ua
/
ISPparrot.astra.in.ua/deb https://parrot.astra.in.ua/ rolling main contrib non-free

APAC

Asia and Pacific

Location
Mirror ID
bandwidth
Provider NameURLAPT config string
Bangladesh
Amberit
1 Gbps
Amberit (formerly Dhakacom)mirror.amberit.com.bd/parrotsecdeb http://mirror.amberit.com.bd/parrotsec/ rolling main contrib non-free
Taiwan
NCHC
20 Gbps
NCHC (Free Software Lab)free.nchc.org.tw/parrotdeb http://free.nchc.org.tw/parrot/ rolling main contrib non-free
Singapore
0x
10 Gbps
0xmirror.0x.sg/parrotdeb https://mirror.0x.sg/parrot/ rolling main contrib non-free
China
USTC
1Gbps CMCC
1Gbps Cernet
300Mbps ChinaNet
University of Science and Technology of China and USTCLUGmirrors.ustc.edu.cn/parrotdeb http://mirrors.ustc.edu.cn/parrot rolling main contrib non-free
China
TUNA
2 Gbps
TUNA (Tsinghua university of Beijing, TUNA association)mirrors.tuna.tsinghua.edu.cn/parrotdeb https://mirrors.tuna.tsinghua.edu.cn/parrot/ rolling main contrib non-free
China
SJTUG
2 Gbps
SJTUG (SJTU *NIX User Group)mirrors.sjtug.sjtu.edu.cn/parrotdeb https://mirrors.sjtug.sjtu.edu.cn/parrot/ rolling main contrib non-free
Japan
wasabi-tokyo
/
wasabi-tokyos3.ap-northeast-1.wasabisys.com/parrot-tokyodeb https://s3.ap-northeast-1.wasabisys.com/parrot-tokyo rolling main contrib non-free
New Caledonia
Lagoon
1 Gbps
Lagoon Networksmirror.lagoon.nc/pub/parrotdeb http://mirror.lagoon.nc/pub/parrot/ rolling main contrib non-free
Thailand
KKU
1 Gbps
KKU (Khon Kaen University)mirror.kku.ac.th/parrotdeb https://mirror.kku.ac.th/parrot/ rolling main contrib non-free
Indonesia
Datautama
1 Gbps
Datautama (PT. Data Utama Dinamika)kartolo.sby.datautama.net.id/parrotdeb http://kartolo.sby.datautama.net.id/parrot/ rolling main contrib non-free

Make your own mirror

You can set up a Parrot archive mirror on your server for personal or public usage by following the steps below.

Make sure to have enough free space

You can sync the entire repository or pick just the ISO images.

Make sure to have enough free space to host a mirror, and be ready for future upgrades as the archive size fluctuates.

The current archive size is available here archive.parrotsec.org/parrot/misc/archive-size.txt

Choose the upstream server

We handle several domains for repository syncing services, we suggest you use rsync.parrot.sh for automatic and failproof setups, but upstream settings can be adjusted in case of specific needs.

Feel free to contact the Parrot team if you have specific mirroring needs or bandwidth limitations. We can provide you dedicated upstream sources or professional support for your mirror.

Main Mirror Director:
    rsync.parrot.sh

Global Zones (read the notes):
    EMEA:
        emea.rsync.parrot.sh
    NCSA:
        ncsa.rsync.parrot.sh
    APAC:
        apac.rsync.parrot.sh

Single archives may be unavailable or replaced from time to time.

rsync.parrot.sh is automatically balanced between all the available mirrors and will give you zero downtimes.

Download the archive

If you sync the entire archive with the below instructions, you do NOT need to synchronize the ISO archive. ISO files are included by default!

Sync the repository

rsync -Pahv --delete-after rsync://rsync.parrot.sh:/parrot /var/www/html/parrot

Configure a cronjob

launch the following command:

crontab -e

and add the following content to the crontab file:

*/10 * * * * flock -xn /tmp/parrot-rsync.lock -c 'rsync -aq --delete-after rsync://rsync.parrot.sh:/parrot /var/www/html/parrot

Download the ISO archive only

Do not sync the ISO archive if you are already synchronizing the full archive with the above instructions. ISO files are already provided with the instructions in the precedent paragraph.

use the following instructions if you want to sync only the ISO files.

Sync the repository

rsync -Pahv --delete-after rsync://rsync.parrot.sh:/parrot-iso /var/www/html/parrot

Configure a cronjob

launch the following command:

crontab -e

and add the following content to the crontab file:

30 2 * * * flock -xn /tmp/parrot-rsync.lock -c 'rsync -aq --delete-after rsync://rsync.parrot.sh:/parrot-iso /var/www/html/parrot

Expose your mirror via rsync

Your mirror can be exposed via rsync to allow other people to sync from you and to allow our mirror director to periodically scan your mirror and perform indexing and health checks.

Rsync exposure is mandatory to add your mirror to our official list.

The following instructions will set up rsync and expose the parrot archive in compliance with our standards on a debian/ubuntu server. Minor adjustments are required for other non-apt systems.

install rsync with:

sudo apt install rsync

edit /etc/rsyncd.conf with nano:

sudo nano /etc/rsyncd.conf

paste the following settings in the config file and save it:

[parrot]
        comment = Parrot OS - full archive [rsync.parrot.sh/parrot]
        path = /var/www/html/parrot/
        hosts allow = *
        #hosts deny = *
        list=true
        uid=www-data
        gid=www-data
        read only = yes
        use chroot=yes
        dont compress # for better performance

[parrot-iso]
        comment = Parrot OS - ISO files only [rsync.parrot.sh/parrot-iso]
        path = /var/www/html/parrot/
        exclude = pool dists
        hosts allow = *
        list=true
        uid=www-data
        gid=www-data
        read only = yes
        use chroot=yes
        dont compress

Enable the rsync service:

sudo systemctl enable rsync    

Start the rsync service:

sudo service rsync start

Make your mirror official

If you want your mirror to be added to our official mirrors list and to our mirror directors, email us at team AT parrotsec DOT org

have fun :)