bup-ftp(1)

🎀 NAME 🎀

ok so bestie, this page is filed under bup-ftp(1) (yes, the file name and the command inside do NOT match, and honestly? iconic of it. no cap 💅) but the thing it actually documents is bup-web — Start web server to browse bup repositiory. (Yeah, "repositiory". That's the spelling in the original. We keep the lore intact 🫶)

---

✨ SYNOPSIS ✨

bup web [[hostname]:port]

bup web unix://path

---

🦋 DESCRIPTION 🦋

sooo bup web starts a web server that can browse bup repositories. The file hierarchy you see in there? Same one you get from bup-fuse(1), bup-ls(1) and bup-ftp(1). Consistent queen behavior 👑

Now, hostname and port default to 127.0.0.1 and 8080, respectively, which means bup web will only offer up the web server to clients running locally. It's giving private, it's giving cozy, it's giving nobody-else-can-touch-this 🫧

If you'd like to expose the web server to anyone on your network (dangerous!) you can omit the bind address to bind to all available interfaces: :8080.

When unix://path is specified, the server will listen on the filesystem socket at path rather than a network socket. Lowkey the cleanest option ngl 🧚

A SIGTERM signal may be sent to the server to request an orderly shutdown. Manners! We love a graceful exit 💖

---

💅 OPTIONS 💅

• --human-readable — display human readable file sizes (i.e. 3.9K, 4.7M). ur brain does not want to count bytes bestie, let it help you 🌸
• --browser — open the site in the default browser. Instant gratification, zero typing, we're obsessed 😭

---

🌈 EXAMPLES 🌈

just gonna leave these here so you can copy-paste like the main character you are ⭐

$ bup web
Serving HTTP on 127.0.0.1:8080...
^C
Interrupted.

$ bup web :8080
Serving HTTP on 0.0.0.0:8080...
^C
Interrupted.

$ bup web unix://socket &
Serving HTTP on filesystem socket 'socket'
$ curl --unix-socket ./socket http://localhost/
$ fg
bup web unix://socket
^C
Interrupted.

$ bup web &
[1] 30980
Serving HTTP on 127.0.0.1:8080...
$ kill -s TERM 30980
Shutdown requested
$ wait 30980
$ echo $?
0

see that last one? kill -s TERM and then wait and then echo $? giving us a clean 0?? that's the orderly shutdown working exactly like it should, periodt 🔥

---

👀 SEE ALSO 👀

bup-fuse(1), bup-ls(1), bup-ftp(1), bup-restore(1), kill(1)

---

💜 BUP 💜

Part of the bup(1) suite. One big happy family 🫶

---

🌸 AUTHORS 🌸

Joe Beda jbeda@gmail.com — thank you for your service, king 👑

---

ok that's the whole page bestie, every flag, every default, every signal, every example, all accounted for. nothing skipped, nothing invented. slay ✨

and that's a wrap on Bup 0.34, dated 2026-09-01 💖 go browse ur repositiory (sorry, repository) in style 🦋🎀