Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nothub/debian-autoinstall
Generate customized Debian ISO images for automatic deployments.
https://github.com/nothub/debian-autoinstall
debian iso preseed
Last synced: about 2 months ago
JSON representation
Generate customized Debian ISO images for automatic deployments.
- Host: GitHub
- URL: https://github.com/nothub/debian-autoinstall
- Owner: nothub
- License: gpl-2.0
- Created: 2022-07-27T22:34:49.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-18T11:22:29.000Z (5 months ago)
- Last Synced: 2024-08-18T12:34:57.429Z (5 months ago)
- Topics: debian, iso, preseed
- Language: Shell
- Homepage:
- Size: 310 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# debian-autoinstall
Generate customized Debian ISO images for automatic deployments.
## Usage
Run `build.sh` to generate a hands-free ISO image.
```
./build.sh [-u username] [-p password] [-n hostname] [-d domain] [-a package] [-i iso_url] [-s sign_key] [-o path] [-x] [-z] [-v] [-h]
```
### Dependencies
Start a [devbox](https://www.jetify.com/devbox) [shell](https://www.jetify.com/devbox/docs/quickstart/#launch-your-development-environment) with:
```sh
devbox shell --pure
```
Or install all dependencies on a Debian 12 system:
```sh
sudo apt update
sudo apt install curl git gnupg pwgen whois xorriso
```
### Clone repo
Clone this repository and `cd` into it.
```sh
git clone https://github.com/nothub/debian-autoinstall.git
cd debian-autoinstall
```
### SSH keys
To include SSH keys for remote access, add them to the `configs/authorized_keys` file.
```sh
curl -fsSLo configs/authorized_keys https://github.com/nothub.keys
echo "ssh-ed25519 AAAA... foo" >> configs/authorized_keys
echo "ssh-ed25519 AAAA... bar" >> configs/authorized_keys
```
### Build ISO
```sh
# set user and password
./build.sh -u 'hub' -p 'changeme'
# set hostname and domain
./build.sh -n 'calculon' -d 'example.org'
# include additional apt packages
./build.sh -a 'strace' -a 'unattended-upgrades'
```
### Flags
```
-u Admin username
-p Admin password
-n Machine hostname
-d Machine domain
-a Additional apt package
-i ISO download URL
-s ISO pgp sign key
-o ISO output file
-x Power off after install
-z Sudo without password
-v Enable verbose mode
-h Display this help message
```
### Password
If the `-p` flag is not set, a random admin password will be generated, printed to stdout and written to `.auth`.
### Hostname
If the `-n` flag is not set, a hostname will be generated at installation.
The hostname will be based on the installed machines mac addresses.
### Restart
If the `-x` flag is not set, the machine will restart after the installation is finished.
## Preseed Config
For an extended example, check:
https://www.debian.org/releases/bookworm/example-preseed.txt
## Debug in VM
While running the installer, press `ctrl`+`alt`+`f4` to show the installers log output.
To switch back to the installers graphical interface, press `ctrl`+`alt`+`f1`.
Switch to any other TTY for an interactive shell.