https://github.com/spiritualhost/debian
Make a copy of a configured Debian machine using a config file
https://github.com/spiritualhost/debian
automation config debian linux
Last synced: 2 months ago
JSON representation
Make a copy of a configured Debian machine using a config file
- Host: GitHub
- URL: https://github.com/spiritualhost/debian
- Owner: spiritualhost
- License: gpl-3.0
- Created: 2025-08-21T16:41:09.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-27T15:58:46.000Z (10 months ago)
- Last Synced: 2025-10-04T08:49:05.712Z (9 months ago)
- Topics: automation, config, debian, linux
- Language: Shell
- Homepage:
- Size: 423 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
### Debian Installation Automation
A basic way of getting a Debian system up and running with minimal effort using past configuration settings. Copy your favorite stuff about your setup into another machine.
## What it does
Using a Debian ISO, the script will take the onerous process of repeatedly setting up Debian machines and automate it. The script assumes a desired set of defaults, all of which can be set easily in the userinfo.sh file. Autoinstallation for Debian systems is to the point where performing that function is really better done that way. A network connection, like Ethernet or WLAN is recommended.
For the purposes of development, I used the netinst CD image for AMD64 (https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-13.0.0-amd64-netinst.iso).
This is strongly inspired by Luke Smith's LARBS (https://github.com/LukeSmithxyz/LARBS) and mostly just seemed like a fun project to do.
The installer script is mostly functional, but could use cleaning up here and there.
## Project Structure
```
debian/
├── installer.sh # Main installation script
├── runtimelog.txt # Script log (name can be changed in configs)
├── user-scripts/ # Optional directory where user scripts can be added
├── configs/ # Default configs for Debian installation
├── userguide/ # PDF (LaTex) with instructions for use
├── README.md
└── LICENSE
```
## How to run it
1) Go through the basic steps of the minimal installation. This can be done by clicking the "Install" option in the Debian bootable media. Before running anything else, run the following script line on your original system to get an overview of the packages needed:
```
echo "PACKAGES=($(apt-mark showmanual | sed 's/.*/\"&\"/' | tr '\n' ' '))"
```
This exact output should be pasted into the userinfo.sh file to replace the $PACKAGES variable → this will ensure that any packages the user installed on the original system will also be installed on the new setup.
2) Clone the repo somewhere convenient. I like to create a folder "~/builds" and then move to a better place later. After the repo has been cloned, you may need to make the script executable with:
```
chmod +x installer.sh
```
3) Run the script with:
```
./installer.sh
```
## Tested Versions of Debian
- Debian 13
- Stable
- Debian 12
- Stable
## Requirements
- Debian installation
- git
- sudo permissions