tftp-proxy(8)

✨ tftp-proxy — the manual page, but make it cute ✨

okay bestie, welcome to tftp-proxy(8), straight out of the System Manager's Manual section 8 💅

---

🎀 NAME 🎀

tftp-proxy — it's a TFTP server, but the plot twist is that when a file isn't hanging out locally, it goes and asks an HTTP backend for it. literally a glow-up for TFTP.

---

🦋 SYNOPSIS 🦋

tftp-proxy -url=http://example.com -dir=/var/lib/tftpboot

that's it. that's the whole vibe. two flags and a dream. ✨

---

🌸 DESCRIPTION 🌸

so this program is a simple TFTP server, right? but with main character energy: if a file is not found locally, it also goes and requests that file from a configured HTTP backend.

that's the entire thing. local files first, then the internet serves looks. slay. 🫶

---

💖 OPTIONS 💖

• -dir=<directory> — the directory it serves files from. Default: /var/lib/tftpboot (yes, that's where your boot files live, iconic behavior).
• -url=<address> — the address of the HTTP server to connect to. Mandatory, bestie. no url, no service. it is not optional and i need you to hear that fr fr. 👑

---

🌈 ENVIRONMENT VARIABLES 🌈

okay so the http_proxy environment variable is respected when fetching files from the HTTP server. 💅

and this might come in handy (handy! ✨) because — plot twist — tftp-proxy does not write any files. so proxying it is, and the env var is right there waiting for you. iykyk.

---

💜 COPYRIGHT&LICENSE 💜

Copyright (C) 2019-2020 Arnoud Vermeer <avermeer@tucows.com>

License (Apache-2.0):

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

On Debian systems, the complete text of the Apache version 2.0 license
can be found in "/usr/share/common-licenses/Apache-2.0".

on Debian systems the full-text Apache 2.0 license is sitting pretty in /usr/share/common-licenses/Apache-2.0 — go read it if you're a nerd about it (affectionate). 📜

---

🧚 AUTHOR 🧚

this manpage is based on the usage output of tftp-proxy and its documentation. it was written for the Debian project by Christoph Biedl <debian.axhn@manchmal.in-ulm.de> — but it may be used by others. so generous, so iconic. 🌟

---

and that's a wrap, babe! 🎀 this little beauty is part of the System Manager's Manual and the page itself is dated 2026-01-29 — go forth, serve those files, and don't forget your -url or she won't start. mwah. 💖✨🦋