SETUP-APKREPOS(8)

📦 version 3.22.0, in alpine 3.24

🎀 SETUP-APKREPOS(8) 🎀

okay bestie, this is the System Manager's Manual page for setup-apkrepos — and it's literally here to help you configure apk package repositories without the chaos. 💅✨

✨ NAME ✨

  • setup-apkrepos — configure apk package repositories 🌸

🦋 SYNOPSIS 🦋

the shapes this command can take, fr fr:

setup-apkrepos [-ch] [-f | -r | -1 | REPO...]

setup-apkrepos -o

💖 DESCRIPTION 💖

setup-apkrepos configures /etc/apk/repositories. It can add a mirror from the Alpine mirror list, write explicit repository URLs, enable matching community repositories, or prompt interactively. all the repo setup energy in one little script 🫶

When a mirror is selected from the mirror list, repositories are written for the current Alpine release. The release is inferred from an existing main repository or from /etc/alpine-release; development and unknown versions fall back to edge. 🧚

After changing repositories, the script runs apk update. ✨

💅 OPTIONS 💅

okay here's the full flag lineup, no cap — every single one:

  • -1 — Add the first mirror from the mirror list, normally the CDN mirror, and do not prompt. 👑
  • -c — Enable the community repository when adding a mirror. Without this option, the generated community repository line is commented out. 💬
  • -f — Find and add the fastest mirror from the mirror list, and do not prompt. 🔥
  • -h — Display usage information and exit. 🫡
  • -o — Only enable a community repository for every main repository already configured in /etc/apk/repositories. 🌈
  • -r — Add a random mirror from the mirror list, and do not prompt. 🎲
  • REPO... — Replace /etc/apk/repositories with the specified repository lines. 📝

big rules, bestie:

  • -o cannot be used with -c, -f, -r, or -1. 🚫
  • -f, -r, and -1 are mutually exclusive. 💀

🌈 INTERACTIVE MODE 🌈

Without non-interactive options or explicit REPO arguments, the script prompts for a setup method. The prompt accepts:

  • f — Find and use the fastest mirror. ⚡
  • s — Show the mirror list. 👀
  • r — Use a random mirror. 🎲
  • e — Edit /etc/apk/repositories with EDITOR or vi. ✍️
  • c — Toggle whether generated mirror entries enable the community repository. 🔁
  • skip — Exit without changing repositories. 🚪
  • number — Add the numbered mirror from the mirror list. 🔢
  • URL or path — Add the specified repository URL or absolute path. 🔗

Adding c after answers such as f c or r c enables community repositories. periodt. 💖

🧚 ENVIRONMENT 🧚

  • MIRRORS_URL — URL used to fetch the Alpine mirror list. The default is https://mirrors.alpinelinux.org/mirrors.txt. 🌐
  • MIRRORS — Whitespace-separated mirror list. If set, setup-apkrepos uses this list instead of fetching MIRRORS_URL. 📋
  • APKREPO_DEFAULT_ANSWER — Default answer used by the interactive prompt. 💬
  • EDITOR — Editor used by the interactive edit command. Defaults to vi. 🖊️

⭐ EXIT STATUS ⭐

  • 0 — Success. 🎉
  • non-zero — An error occurred. 😭

🍓 FILES 🍓

  • /etc/apk/repositories — apk repository configuration file. 📁
  • /etc/alpine-release — Alpine release file used to choose the repository release. 🏷️

🔥 SEE ALSO 🔥

check out apk(8) and setup-alpine(8) — besties for sure. 💜

👑 AUTHORS 👑

shoutout to Natanael Copa <ncopa@alpinelinux.org> and others. 🫶

mwah 💋 source/version: Alpine Linux; date: 2026-06-09. periodt. 🎀✨

📦 where this page comes from