Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jsamr/bootiso
A bash program to securely create a bootable USB device from one image file.
https://github.com/jsamr/bootiso
bash bash-script bootable bootable-usb iso secured usb usb-stick
Last synced: 4 days ago
JSON representation
A bash program to securely create a bootable USB device from one image file.
- Host: GitHub
- URL: https://github.com/jsamr/bootiso
- Owner: jsamr
- License: gpl-3.0
- Created: 2018-04-04T17:22:27.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-08-28T22:11:34.000Z (over 2 years ago)
- Last Synced: 2025-01-01T06:06:58.656Z (11 days ago)
- Topics: bash, bash-script, bootable, bootable-usb, iso, secured, usb, usb-stick
- Language: Shell
- Homepage: https://jsamr.github.io/bootiso
- Size: 2.27 MB
- Stars: 810
- Watchers: 28
- Forks: 88
- Open Issues: 15
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - jsamr/bootiso - A bash program to securely create a bootable USB device from one image file. (Shell)
README
[](https://www.gnu.org/licenses/gpl-3.0.html)
[](https://github.com/jsamr/bootiso/releases/latest)
[](https://app.codacy.com/app/jsamr/bootiso?utm_source=github.com&utm_medium=referral&utm_content=jsamr/bootiso&utm_campaign=badger)
**Create a USB bootable device from an image file easily and securely.**
Because of its reliance on GNU and POSIX tools, **bootiso** primarly targets GNU/Linux systems.
## Install
### Package managers
This list might be out of date (please report). Check [repology.org](https://repology.org/project/bootiso/versions).
| System family | URL |
| :----------------- | ----------------------------------------------------------------------- |
| Arch Linux (AUR) | https://aur.archlinux.org/packages/bootiso/ |
| Void Linux | https://github.com/void-linux/void-packages/tree/master/srcpkgs/bootiso |
| openSUSE (OBS) | https://build.opensuse.org/package/show/utilities/bootiso |
| OpenMandriva (ABF) | https://abf.openmandriva.org/openmandriva/bootiso/build_lists |
### Manual install
Check [Install Instructions](install.md) document. Please also read the [distro tweaks](#distro-tweaks) section.
## Reference Manual
The official manual is available at [jsamr.github.io/bootiso](https://jsamr.github.io/bootiso/).
The reference should also be available as a man page via `man bootiso`.
If you are in a hurry, jump to the [EXAMPLES](https://jsamr.github.io/bootiso/#EXAMPLES) section.
| Highlights |
| :-----------------------------------------------------------------: |
| [SYNOPSIS](https://jsamr.github.io/bootiso/#SYNOPSIS) |
| [DESCRIPTION](https://jsamr.github.io/bootiso/#DESCRIPTION) |
| [INSTALL MODES](https://jsamr.github.io/bootiso/#INSTALL_MODES) |
| [GUARDRAILS](https://jsamr.github.io/bootiso/#GUARDRAILS) |
| [EXIT STATUS](https://jsamr.github.io/bootiso/#EXIT_STATUS) |
| [ENVIRONMENT](https://jsamr.github.io/bootiso/#ENVIRONMENT) |
| [EXAMPLES](https://jsamr.github.io/bootiso/#EXAMPLES) |
| [TROUBLESHOOTING](https://jsamr.github.io/bootiso/#TROUBLESHOOTING) |
## See it in action
### Probing
`--probe` (shorten `-p`) gives you details about ISO boot capabilities and list available USB drives.
### Using `--assume-yes` + `--autoselect`
`--assume-yes` (shorten `-y`) bypass prompting the user for overwritting USB device, and `--autoselect` (shorten `-a`) allow automatic selection of USB device when exactly one device is connected in combination with `--assume-yes`.
### No-USB device failure
In the below example, the selected device with `--device` (shorten `-d`) flag is not connected through USB and `bootiso` fails.
## Distros tweaks
- On Fedora, set `BOOTISO_SYSLINUX_LIB_ROOT` environment to `/usr/share/syslinux`.
- Take a look at the [by-distribution dependency table](install.md#deps) to make sure you have all required dependencies installed.
## Contributing
Read the [Code Style and Conventions](style.md) document.