Linux Dev Setup (Headless-friendly)

A streamlined repository to bootstrap a Linux development environment optimized for headless servers. It automates the installation and configuration of essential tools, shells, editors, containers, and optional security hardening.

Features

• Automatic Linux distribution detection supporting apt, dnf, pacman, zypper, and brew.
• Shell setup with oh-my-zsh and Powerlevel10k prompt, including ASCII fallback for terminals without Nerd Font support.
• Neovim configured with lazy.nvim and popular plugins such as Treesitter, LSP, and Telescope.
• Container tools including Docker with optional rootless mode.
• Utilities like direnv, fzf, ripgrep, fd, bat, eza, jq, and yq.
• Optional security hardening with ufw, fail2ban, and sshd configurations.
• Repair targets for zsh and neovim configurations.

Tech Stack

• Shell scripting for automation.
• Makefile orchestration for modular installation steps.
• Nix flake support (flake.nix present) for reproducible environments.

Getting Started

Clone the repository:

git clone https://github.com/justin-napolitano/linux-dev-setup.git
cd linux-dev-setup

Run the full installation:

make install

Alternatively, run specific installation components:

make install-shell       # Setup shell environment
make install-editor      # Setup Neovim editor
make install-headless    # Install headless tools
make install-containers  # Setup container tools (Docker etc.)
make install-security    # Optional security hardening
make fix-zsh             # Repair zsh, oh-my-zsh, Powerlevel10k & plugins
make fix-vim             # Repair Neovim config & plugins

Environment Flags

• ROOTLESS_DOCKER=1 enables rootless Docker during container installation.
• NO_ICONS=1 forces ASCII Powerlevel10k prompt without Nerd Font glyphs.

Project Structure

010_nix_init.sh        # Nix initialization script
flake.nix              # Nix flake configuration
Makefile               # Orchestrates installation and fixes
Makefile.bak           # Backup of Makefile
README.md              # Project documentation
scripts/               # Installation and fix scripts
  ├─ 004_ensure_openai_key.sh  # ChatGPT/OpenAI key management
  ├─ 005_link_key_to_shell.sh  # Link OpenAI key to shell environment
  ├─ 006_install_chatgpt_cli.sh # Install ChatGPT CLI
  ├─ 007_install_openai_python.sh # Install OpenAI Python client
  ├─ 008_verify_openai_env.sh  # Verify OpenAI environment variables
  ├─ 009_bootstrap_nvm.sh      # Node Version Manager bootstrap
  ├─ 12_shell.sh               # Shell environment setup
  ├─ 25_editor_nvim.sh         # Neovim setup
  ├─ 35_headless_tools.sh      # Headless tool installation
  ├─ 36_containers.sh          # Container tools setup
  ├─ 50_security.sh            # Security hardening setup
  ├─ fix_zsh.sh                # Fix zsh environment
  └─ fix_vim.sh                # Fix Neovim environment

dotfiles/               # User dotfiles (assumed)

Future Work / Roadmap

• Expand support for additional Linux distributions and package managers.
• Enhance Nix flake integration for fully reproducible environments.
• Add more granular configuration options for installed tools.
• Integrate automated testing for installation scripts.
• Extend security hardening with audit and compliance checks.

---

This setup aims to simplify and standardize Linux development environment provisioning, especially for headless or remote servers.