# dl-fedora
[](https://hackage.haskell.org/package/dl-fedora)
[](LICENSE)
[](http://stackage.org/lts/package/dl-fedora)
[](http://stackage.org/nightly/package/dl-fedora)
A tool for downloading Fedora, ELN, and Centos Stream images.
By default it targets the Workstation edition of Fedora.
Usage examples:
`dl-fedora rawhide` : downloads the latest Fedora Rawhide Workstation Live iso
`dl-fedora 39 silverblue` : downloads the Fedora Silverblue iso
`dl-fedora respin kde` : downloads the latest KDE Live respin
`dl-fedora 38 server --arch aarch64` : will download the Server iso for armv8
`dl-fedora --run 39` : will download Fedora Workstation and boot the Live image with qemu-kvm.
`dl-fedora --local rawhide` : shows the current locally available image (as well as the latest one). With `--dryrun` it doesn't check for newest iso.
`dl-fedora c9s` : downloads a Centos Stream 9 net installer.
By default dl-fedora downloads to `~/Downloads/`
(correctly the XDG user "DOWNLOADS" directory),
but if you create an `iso` subdirectory there (`~/Downloads/iso/`)
it will use that directory instead.
`dl-fedora` downloads the latest image redirected from `download.fedoraproject.org` by default, after checking for the latest image at `dl.fedoraproject.org`.
However if the mirror is not synced yet it will download from `dl.fedoraproject.org` instead. You can use `--no-dl` to avoid checking and downloading from the main dl.fedoraproject.org mirror (in this case a nightly image might not be the very latest).
If the image is already found to be downloaded
it will not be re-downloaded of course.
Curl is used to do the downloading: partial downloads will continue.
A symlink to the latest iso is also created:
eg for rawhide it might be `"Fedora-Workstation-Live-x86_64-Rawhide-latest.iso"`.
It also tries to check the iso checksum and its gpg signature.
## Usage
```shellsession
$ dl-fedora --version
0.9.6
$ dl-fedora --help
Fedora iso downloader
Usage: dl-fedora [--version] [-g|--gpg-keys]
[(-C|--no-checksum) | (-c|--checksum)] [-n|--dry-run] [--debug]
[-T|--no-http-timeout] [-l|--local] [-r|--run] [-R|--replace]
[(-d|--dl) | (-D|--no-dl) | (-k|--koji) | (-m|--mirror URL)]
[--cs-devel | --cs-test] [-a|--arch ARCH] RELEASE [EDITION]
Tool for downloading Fedora iso file images.
RELEASE = release number, respin, rawhide, test (Beta), stage (RC), eln, c8s, c9s
EDITION = {cloud,container,everything,server,workstation,silverblue,kinoite,
sericea,budgie,cinnamon,i3,kde,lxde,lxqt,mate,soas,sway,
xfce} [default: workstation]
See <https://fedoraproject.org/wiki/Infrastructure/MirrorManager>
and also <https://fedoramagazine.org/verify-fedora-iso-file>.
Available options:
-h,--help Show this help text
--version Show version
-g,--gpg-keys Import Fedora GPG keys for verifying checksum file
-C,--no-checksum Do not check checksum
-c,--checksum Do checksum even if already downloaded
-n,--dry-run Don't actually download anything
--debug Debug output
-T,--no-http-timeout Do not timeout for http response
-l,--local Show current local image via symlink
-r,--run Boot image in Qemu
-R,--replace Delete previous snapshot image after downloading
latest one
-d,--dl Use dl.fedoraproject.org (dl.fp.o)
-D,--no-dl Do not use dl.fp.o (even if newer)
-k,--koji Use koji.fedoraproject.org
-m,--mirror URL Mirror url for /pub [default
https://download.fedoraproject.org/pub]
--cs-devel Use centos-stream development compose
--cs-test Use centos-stream test compose (default is
production)
-a,--arch ARCH Specify arch [default: x86_64]
```
## Contribution
dl-fedora is distributed under the GPL 3 license or later.
Please report issues or pull requests at <https://github.com/juhp/dl-fedora>.