Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/RackunSec/dciso
These are scripts I made to help with the design and customization of a Debian ISO (Primarily WeakerThan Linux)
https://github.com/RackunSec/dciso
Last synced: about 1 month ago
JSON representation
These are scripts I made to help with the design and customization of a Debian ISO (Primarily WeakerThan Linux)
- Host: GitHub
- URL: https://github.com/RackunSec/dciso
- Owner: RackunSec
- Archived: true
- Created: 2016-02-17T14:54:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-10-06T20:35:53.000Z (almost 2 years ago)
- Last Synced: 2024-07-30T14:19:17.487Z (about 2 months ago)
- Language: Shell
- Size: 851 KB
- Stars: 82
- Watchers: 10
- Forks: 36
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-hacking-lists - RackunSec/dciso - These are scripts I made to help with the design and customization of a Debian ISO (Primarily WeakerThan Linux) (Shell)
README
# Debian Custom ISO Builder
`dciso` is a tool that I made to help with the design and customization of a Debian ISO (Primarily [DEMON LINUX](https://demonlinux.com/)). These scripts have recently been updated to accomodate newer distributions of Debian: Bullseye. The previous version of these scripts relied on [Live-Build](https://live-team.pages.debian.net/live-manual/html/live-manual/index.en.html) which is no longer a necessary tool and has been removed due to contrived user complexity.
```
Debian Custom ISO Utility
(c) GNU 2022 - @RackunSec
Usage: ./dciso (args)
Arguments:
Dependencies:
install-dep - Install all dciso dependencies.
Chroot Tools:
build-chroot (RELEASE) - Build the chroot directory.
start-chroot - Starts a chroot session in ./chroot.
end-chroot - Ends the current chroot session from ./chroot
clean - Destroys the chroot directory.
In Chroot Tools:
in-init - Performs first time set of of the chroot, should be ran within chroot.
in-start-chroot - Sets up the current chroot session, should be ran within chroot.
in-end-chroot - ends the current chroot session, should be ran within chroot.
Generate an ISO:
mkiso (ISO NAME).iso - Will create an ISO file from ./chroot
```
## Installation
To install, run the following commands:
```bash
git clone https://github.com/RackunSec/debian-custom-iso-builder.git
cd debian-custom-iso-builder
chmod +x dciso
./dciso install-dep # This will install all dependencies
```
## Building your Custom ISO
To build an ISO, we need a chroot to work out of and make our customizations. We build the chroot with the following command:
```bash
./dciso build (RELEASE)
```
Where "RELEASE" is the Debian release that you want to customize. E.g.: buster, bullseye, etc. This script will build a `chroot/` directory. Next we need to put a few tool into the chroot to access it while chrooted:
### Chroot Access and Customizations
Now, simply start the chroot shell with the following command:
```bash
./dciso start-chroot
```
Once within the chroot shell, run the tool we passed to it with:
```bash
/etc/live-tools/dciso init # installs a lot of stuff
/etc/live-tools/dciso in-start-chroot # starts the chroot and mounts stuff for x11
```
Now, we are ready to begin installing packages and making our customizations. If you install `Xfce4`, you can simply run `startx` from the command line and customize the desktop/menus/etc.
### Exit Chroot
Once completed, run
```bash
/etc/live-build/dciso in-end-chroot
```
and exit the chroot shell with `CTRL+D` and run:
```bash
./dciso end-chroot
```
It will recommend that you reboot - please do to ensure that nothing is mounted within the chroot before generating your ISO!
## Generate the ISO
Finally, generate the ISO file with the following command:
```bash
./dciso geniso (ISO NAME).iso
```
# Demon Linux Specific Items
I built in a question that get's asked when you run `/etc/live-tools/dciso in-init` in your chroot which will install a base Demon Linux system if so inclined. Also, if you'd like the Demon Linux Bash shell prompt theme, use this in your `~/.bashrc` file:
### Root:
```bash
PS1='\n\[\033[48;5;;38;5;240m\]╭╴\[\e[m\]\[\e[1m\]${debian_chroot:+($debian_chroot)}\[\e[m\]\[\e[3m\]\u\[\e[m\]\[\033[48;5;;38;5;243m\]\[\e[3m\]＠\[\e[m\]\[\e[3m\]\h\[\e[m\]\[\033[48;5;;38;5;249m\]\[\033[48;5;;38;5;239m\]\[[\033[48;5;;38;5;243m\]\[\e[3m\]\D{%m/%d/%Y %H:%M:%S}\[\e[m\]\[\033[48;5;;38;5;239m\]]\[\033[48;5;;38;5;240m\[\e[m\]\n\[\033[48;5;;38;5;239m\]╰⌊\[\e[3m\]\[\033[48;5;;38;5;247m\]\w\[\e[m\]\[\e[m\]\[\033[48;5;;38;5;239m\]⌋\[\033[00m\]\[\033[48;5;;38;5;196m\]→ \[\e[m\]';
```
### User:
```bash
PS1='\n\[\033[48;5;;38;5;240m\]╭╴\[\e[m\]\[\e[1m\]${debian_chroot:+($debian_chroot)}\[\e[m\]\[\e[3m\]\u\[\e[m\]\[\033[48;5;;38;5;243m\]\[\e[3m\]＠\[\e[m\]\[\e[3m\]\h\[\e[m\]\[\033[48;5;;38;5;249m\]\[\033[48;5;;38;5;239m\]\[[\033[48;5;;38;5;243m\]\[\e[3m\]\D{%m/%d/%Y %H:%M:%S}\[\e[m\]\[\033[48;5;;38;5;239m\]]\[\033[48;5;;38;5;240m\[\e[m\]\n\[\033[48;5;;38;5;239m\]╰⌊\[\e[3m\]\[\033[48;5;;38;5;247m\]\w\[\e[m\]\[\e[m\]\[\033[48;5;;38;5;239m\]⌋\[\033[00m\]→ ';
```