SETUP-PROXY(8)

πŸ“¦ version 3.22.0, in alpine 3.24

πŸ’… SETUP-PROXY πŸ’…

ok so bestie, welcome to setup-proxy(8), straight out of the System Manager's Manual β€” yes it's a section 8 page, yes it's iconic, and yes it's about to make your whole system's proxy situation make sense. grab a snack πŸ“


✨ NAME ✨

setup-proxy β€” configure HTTP/FTP proxy settings. that's it. that's the whole vibe. πŸŽ€


🌸 SYNOPSIS 🌸

setup-proxy [-hq] [PROXYURL]

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea β˜• β€” setup-proxy configures the system-wide HTTP, HTTPS and FTP proxy. not just for one app, not just for your shell, for the whole system, main character energy fr πŸ‘‘

it does two things:

  • writes the proxy environment to /etc/profile.d/proxy.sh
  • installs wget, because the busybox wget does not support HTTP proxies (lowkey tragic, i know 😭)

in interactive mode, the proxy URL has to be an HTTP or HTTPS URL (like http://proxy:8080) or none. the value none removes the proxy configuration β€” poof, gone, no proxy era πŸ’…

if PROXYURL is given, it's used directly, no questions asked. if it's omitted, the current proxy setting becomes the default and the user gets prompted. so you're never just guessing 🫢


✨ OPTIONS ✨

  • -h β€” display usage information and exit. short, sweet, helpful 🌈
  • -q β€” quiet mode. suppresses the reminder to source the profile after setup. she's not gonna nag you, she's gonna let you live πŸ’€

πŸŽ€ FILES πŸŽ€

  • /etc/profile.d/proxy.sh β€” shell script exporting http_proxy, https_proxy, ftp_proxy and no_proxy environment variables. all four of them, all slaying in one file πŸ’–

⭐ EXIT STATUS ⭐

  • 0 β€” success. we ate and left no crumbs πŸ”₯
  • non-zero β€” an error occurred. it's giving chaos, check your input πŸ™ˆ

πŸ‘‘ SEE ALSO πŸ‘‘

wget(1), setup-alpine(8) β€” go read those too, bestie, iykyk 🧚


πŸ’œ AUTHORS πŸ’œ

Natanael Copa <ncopa@alpinelinux.org> and others β€” absolute legends, no cap 🫑


ngl, the quiet flag -q only hides the "source your profile" reminder. it's not a magic silence-everything button, so don't come for her πŸ’€

that's the whole page, bestie β€” brought to you by Alpine Linux, dated 2026-06-09, and written with so much love. now go configure that proxy and slay βœ¨πŸ¦‹πŸ’…

πŸ“¦ where this page comes from