Files
public-setupfiles/.github/wiki/Linux-Setup.md
WickedYodaandJarvis 0c62f7495a docs: add READMEs and wiki documentation for all directories
- Add comprehensive wiki documentation under .github/wiki/ (19 articles)
- Add READMEs to directories that lacked them
- Fix merge conflict markers in existing READMEs
- Update root readme.md with improved structure

Co-authored-by: Jarvis <jarvis@wickedyoda.local>
2026-09-04 12:31:11 -05:00

3.5 KiB

Linux Setup

Debian and Ubuntu system configuration scripts.


Debian Files

debian-files/

Script Purpose
install-bashtop.sh Install system monitoring tool
update_tailscale.sh Update Tailscale with keyring

Bashtop Installation

sudo ./debian-files/install-bashtop.sh

Installs from GitHub source (latest development version).

Tailscale Update

sudo ./debian-files/update_tailscale.sh

Features:

  • Detects Debian/Ubuntu/Raspbian
  • Normalizes codenames (bullseye, bookworm, etc.)
  • Falls back to legacy apt-key for older releases
  • Installs from official Tailscale repo

Debian Distro Upgrades

debian-dist-upgrades/

File Purpose
README.md This documentation
dist-upgrade.sh Interactive upgrade script

dist-upgrade.sh

sudo ./debian-dist-upgrades/dist-upgrade.sh

Supported upgrades:

  • Debian 11 → 12 (stable)
  • Debian 12 → 13 (testing)

Options:

1) apt upgrade (security + bug fixes)
2) apt full-upgrade (recommended)
3) Debian distro upgrade (major version)
4) Convert to Parrot Linux (security-focused)

Safety features:

  • Backup of /etc/apt/sources.list
  • Double confirmation for Parrot conversion
  • Automatic dependency handling

Server Configuration

server_config/

server_config/debian/

File Purpose
debian-setup.sh Initial Debian server setup

Commands included:

# Install basic tools
apt install -y wireshark nmap openvpn etherape remmina monitorix

# Install networking
apt install -y openssh-server smbclient cifs-utils

# Install utilities
apt install -y curl unattended-upgrades cron-apt git

server_config/ubuntu/

File Purpose
ubuntu-setup.sh Ubuntu server initial setup
ubuntu-docker-install.sh Docker on Ubuntu

fstab Setup

fstab-setup/

File Purpose
Fstab entries.txt NAS mount configuration examples
setup-fstab.sh Generate and apply fstab entries
setup-fstab-remake-mnt.sh Reset and remount

NAS Mount Entries

# Public share
//nas/public  /media/naspublic  cifs  vers=2.0,username=admin,password=YOURPASS,file_mode=0777,dir_mode=0777,_netdev,auto 0 0

# Media share
//nas/DownloadedMedia  /media/nasmedia  cifs  vers=2.0,username=admin,password=YOURPASS,file_mode=0777,dir_mode=0777,_netdev,auto 0 0

Setup Script

sudo ./fstab-setup/setup-fstab.sh

What it does:

  1. Backs up existing /etc/fstab
  2. Creates mount points
  3. Appends new entries
  4. Runs mount -a to activate

Reset Permissions

reset_perms/

File Purpose
reset_perms.sh Reset permissions on mount points
reset_perms 1.sh Alternative version

Usage

sudo ./reset_perms/reset_perms.sh

Resets:

/mnt/public      /dev/sdc1
/mnt/public-bk   /dev/sde1
/mnt/public2     /dev/sdd1
/mnt/public2-bk  /dev/sdb1
/mnt/timeshift   bind mount from public2
/mnt/timeshift1  bind mount from public2-bk

Sets:

  • Ownership: root:root
  • Permissions: 777 (world read/write/execute)

Gather Logs

gather-logs/

Script: gather_logs.sh

./gather-logs/gather_logs.sh

Collects:

  • /var/log/syslog, /var/log/auth.log, /var/log/kern.log
  • journalctl output (current boot + all)
  • System info: hostname, uname, df, free, ip addr
  • Failed systemd units

Output: /tmp/{date}-{hostname}.zip