tldr-pages/tldr

Page request: mirrorselect

Open

#22022 opened on Apr 12, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Shell (30,937 stars) (2,507 forks)batch import
help wantednew command

Description

Command description

mirrorselect

Selects GENTOO_MIRRORS and the Gentoo rsync mirror with a TUI. More information: https://wiki.gentoo.org/wiki/Mirrorselect

  • Opens up an interface for mirror selection: sudo mirrorselect -i

  • Opens up an interface of the specified country for mirror selection: sudo mirrorselect -i -c "United States (USA)"

  • Selects the 3 fastest servers by download speed (may take a while): mirrorselect -s3 -b10 -D

  • Opens up an interface to choose a rsync mirror to output into the file: mirrorselect -i -r -o >> /etc/portage/repos.conf/gentoo.conf

Command details

2.5.4-r1

Documentation

https://wiki.gentoo.org/wiki/Mirrorselect

Platform

Linux

VCS repository link (e.g. GitHub, GitLab)

https://gitweb.gentoo.org/proj/mirrorselect.git/

Additional information

Complete noob -- I couldn't make a PR so I hope by here is fine.

Contributor guide

Tech stack
shell
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
95
Research direction
Add a new page for the mirrorselect command under pages/linux/. Follow the tldr page format as described in CONTRIBUTING.md. The issue provides example commands that should be included. Ensure the page includes proper syntax descriptions and references the official documentation.