File: README.md

package info (click to toggle)
grml2usb 0.20.10
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 680 kB
  • sloc: python: 1,500; sh: 330; asm: 225; makefile: 70
file content (57 lines) | stat: -rw-r--r-- 1,765 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# grml2usb

[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-purple?logo=github)](https://github.com/sponsors/grml)
[![GitHub release](https://img.shields.io/github/v/release/grml/grml2usb)](https://github.com/grml/grml2usb/releases)
[![Debian package](https://img.shields.io/debian/v/grml2usb/trixie?label=debian)](https://packages.debian.org/trixie/grml2usb)
[![Ubuntu package](https://img.shields.io/ubuntu/v/grml2usb)](https://packages.ubuntu.com/search?keywords=grml2usb)

Install [Grml](https://grml.org/) Live Linux to a USB key drive.

## Purpose

This tool installs a Grml ISO image (or a running Grml) to USB drives, making them bootable.
You can install multiple Grml flavours on the same USB drive, for example both `amd64` and `arm64` versions.

## Installation

### From Debian repositories

```bash
sudo apt install grml2usb
```

### From GitHub releases

Download the latest release from [GitHub Releases](https://github.com/grml/grml2usb/releases), and then:

```bash
# Download and install .deb package
sudo apt install ./grml2usb_*.deb
```

## Quick Start

1. Install `grml2usb` package
2. [Download a Grml ISO image](https://grml.org/download/)
3. Install it to USB device:
   ```bash
   sudo grml2usb grml.iso /dev/sdX1
   ```

**Warning:** Replace `/dev/sdX1` with the FAT partition on your USB device.
This will destroy all data on the device.

## Documentation

For detailed usage instructions and all available options, visit: https://grml.org/grml2usb/

## License

This project is licensed under the GPL v2+.

## Contributing

- **Source code**: https://github.com/grml/grml2usb
- **Issues**: https://github.com/grml/grml2usb/issues
- **Releases**: https://github.com/grml/grml2usb/releases
- **Grml Live Linux**: https://grml.org