A portable, modular, and open-source Linux setup toolkit :-: including dotfiles, automation scripts, and system cleanup tools for Debian, Ubuntu, Arch, and more. Perfect for quickly bootstrapping your development or workstation environment.
linux-setup/
├── dotfiles/ # Modular dotfiles (.aliasesrc, .aptrc, etc.)
├── scripts/ # Core shell scripts (init, profile generation, helpers)
├── etc/cron.daily/ # Optional system-level cron jobs
├── install.sh # Main installation script (detects Bash/Zsh)
├── bootstrap.sh # Script to generate this folder structure
├── README.md # This documentation
└── LICENSE # License file
# Debian/Ubuntu
sudo apt update && sudo apt install -y git curl
# Manjaro/Arch
sudo pacman -Sy --noconfirm git curlgit clone https://github.com/YOUR_USERNAME/linux-setup.git ~/linux-setup
cd ~/linux-setupReplace
YOUR_USERNAMEwith your GitHub username.
cd scripts/../resources # or wherever install.sh is located
bash install.shThis will:
- Detect your shell (bash or zsh)
- Generate a
.profileor.zshrcby merging dotfiles - Ensure it's sourced in
.bashrcor.zshrc
source ~/.bashrc # or source ~/.zshrcThe setup includes functions you can use after installing:
cleanup # Runs OS-specific cleanup (apt, pacman, etc.)
cleanupThumbnails # Removes thumbnail cache from ~/.cache/thumbnailsYou can recreate this structure from scratch using:
bash bootstrap.shThis will create all necessary folders and files if missing.
This project is licensed under the MIT License. See LICENSE for details.
This repository includes a collection of optional installation scripts located in the scripts/ directory. These
scripts install useful software such as:
- Git
- Chromium
- Gnome Sushi
- GIMP
- Node.js
- Audacious
- Keepass2
- Calibre
- and more...
After cloning this repository and running the main setup, you can run any optional install script manually like so:
bash ./scripts/install-git.sh
bash ./scripts/install-chromium.sh
bash ./scripts/install-gnome-sushi.shThese scripts are safe to run individually, so you can pick and choose what you need.
If you want to safely create a bootable Linux Live USB using the dd command, check out the helper script and
documentation in:
py_script/py_script_create_live_usb_dryrun_doc.md