FREIGHT(5)

📦 version 0.3.13, in epel 9, fedora 43, fedora 44

✨ FREIGHT(5) ✨

okay bestie so this is the freight man page, section 5, and it's literally just the whole configuration vibe. buckle up 🎀

💖 NAME 💖

freight — Freight configuration

🌸 DESCRIPTION 🌸

The Freight configuration is a sourced shell script that defines a few important variables. that's it. that's the whole thing. it's giving "tiny file, huge responsibility" and honestly? iconic. 👑

✨ OPTIONS ✨

these aren't like command-line flags bestie, they're the variables you set in that shell script. every single one matters:

  • VARLIB — The Freight library directory. Typically /var/lib/freight.
  • VARCACHE — The Freight cache directory. Typically /var/cache/freight. 🚨 this one should be the document root of the web server, no cap.
  • ARCHS — The architectures to support. Typically i386 amd64.
  • ORIGIN — The Origin field in the Debian archive.
  • LABEL — The Label field in the Debian archive.
  • NOT_AUTOMATIC — The NotAutomatic field in the Debian archive.
  • BUT_AUTOMATIC_UGPRADES — The ButAutomaticUpgrades field in the Debian archive. (yes, that spelling is literally what it says, i'm not touching it 💅)
  • CACHE — on to cache package control files or off to read them from the packages on each freight-cache(1) run.
  • GPG — The GPG key(s) to use. This value must be set either in a configuration file or by using the -g option to freight-cache(1). Multiple keys can be given to sign the repository with more signatures. the way that more signatures = more slay 🫶
  • GPG_PASSPHRASE_FILE — Pathname of a file containing the GPGP private key´s passphrase. This sets the --passphrase-fd and --passphrase-file options to gpg(1). The passphrase file can be set either in a configuration file or by using the -p option to freight-cache(1).
  • GPG_DIGEST_ALGO — Message digest algorithm that GPG should use to sign the repository. Apt is phasing out SHA1 so it is recommended to use SHA512 for most use-cases. This sets the --personal-digest-preferences option to gpg(1). The digest algorithm can be set either in a configuration file or by using the -a option to freight-cache(1).
  • SYMLINKS — on to follow symbolic links in VARLIB to produce extra components in the cache directory or off to offer no special treatment.

🦋 FILES 🦋

where your config can live, in order of "who's the main character":

  • /etc/freight.conf — The default configuration file.
  • ~/.freight.conf — User-specific configuration file.
  • etc/freight.conf, .freight.conf — Directory-specific configuration files.

🌈 ENVIRONMENT VARIABLES 🌈

  • FREIGHT_CONF — The pathname of an alternate configuration file.

🎶 THEME SONG 🎶

The New Pornographers — "All the Old Showstoppers"

(not me putting a whole theme song in a manpage 😭 this is the most main character energy i've ever seen, iykyk)

👑 AUTHOR 👑

Richard Crowley r@rcrowley.org

💜 SEE ALSO 💜

  • freight-add(1) adds packages to the intermediate "Freight library" that is used by freight-cache(1) to build the actual repositories.
  • reprepro(1) manages Debian archives, too, if Freight isn´t your thing.
fr fr, if you skip setting GPG, nothing is gonna sign and you're gonna have a bad time. set the variable, set the flag, do the thing. periodt. 💅

okay that's the whole page bestie!! this version is from Freight, dated March 2016 — go forth and configure, you've got this 🎀💖✨

📦 where this page comes from