JIGDO-MIRROR(1)

📦
version 0.8.2 · 2 versions
, in epel 10, epel 9, fedora 43, fedora 44

💖 jigdo-mirror(1) — the manual, but make it slay 💖

Okay bestie, so this is jigdo-mirror(1), and if you're here it's because you want to be the person who actually serves the files, not just download them like a civilian. Let's get into it ✨

📛 NAME

jigdo-mirror — literally just here to maintain a mirror of images offered with jigdo. That's the whole gig, and it eats. 👑

⌨️ SYNOPSIS

jigdo-mirror [ config-file ]

That's it. One optional argument, she's low maintenance. 🎀

🌸 DESCRIPTION

First things first, if you have no idea what Jigsaw Download even is, go read jigdo-file(1) for the intro. It's giving prerequisite reading, bestie. 💅

So jigdo-mirror is a script — and no cap, it's for a very specific kind of main character: the one who wants to offer direct HTTP or FTP downloads of files where only the jigdo and template files are available. Like, the actual image content isn't sitting there yet, and you're about to be the hero who makes it downloadable. Iconic. 🌈

🦋 Step one: set up your mirroring

The way this works, as the first step of using jigdo-mirror, you need to set up a normal HTTP/FTP/rsync mirroring — both of the .jigdo/.template files and of the parts that are needed for the reconstruction of the images. Both. Not one. Both. 🫶

Concrete example, because I gotchu: if you want to mirror Debian CD images with jigdo-mirror, you need two things on the local machine:

  • a mirror of the .jigdo/.template files
  • a Debian mirror

That's the vibe check, and you need both to pass. ✅

⏰ Step two: schedule it, bestie

Then, at regular intervals — and preferably immediately after your normal mirroring has finished, timing is everything — you schedule a run of jigdo-mirror. It's going to search through a given directory for any .jigdo files and attempt to create all images offered by each file. All of them. It does not do half measures. 🔥

🧚 Step three: the settings situation

Okay so here's the part where you need to pay attention. The script requires you to set a number of variables — please refer to the start of /usr/bin/jigdo-mirror for a description of each of them. Go look at the top of the file, it literally explains everything. 📖

⚠️ And now the important bit: /usr/bin/jigdo-mirror will be overwritten whenever you upgrade jigdo-mirror. So it is highly recommended not to change the settings directly in this script. Like, don't do it. Don't be that person. 😭

Instead, your personal settings should be saved in a file called .jigdo-mirror in your home directory — or, if you're feeling fancy, in a different file whose name is then passed to the script as its first (and only) command line argument. One argument. Singular. Periodt. 💀

👀 SEE ALSO

CD images for Debian Linux can be downloaded with jigdo <URL:http://www.debian.org/CD/jigdo-cd/>. Go get your CDs, bestie. 🍓

👑 AUTHOR

Jigsaw Download <URL:http://atterer.org/jigdo/> was written by Richard Atterer <jigdo atterer.org>, to make downloading of CD ROM images for the Debian Linux distribution more convenient. We stan a convenience king. 💜

✨ That's the whole page, no notes. ✨

This lil masterpiece is from May 04, 2002 — yes, she's vintage, she's a classic, and she's still serving JIGDO-MIRROR(1) realness. 🎀🦋💖

📦 where this page comes from