bootstrap.sh self-elevates with sudo; USB install docs rewritten
bootstrap.sh: add self-elevation — if not root, re-exec under sudo.
Double-clicking the script in GNOME ("Run in Terminal") now prompts for
the sudo password automatically, no extra commands needed.
README: rewrite USB section around the real workflow:
- clone with "Open in Terminal" from the file manager sidebar
- Option A: right-click folder → Open in Terminal → sudo ./setup.sh
- Option B: double-click bootstrap.sh → "Run in Terminal?" → sudo prompt
- note on nautilus-extension-gnome-terminal and exFAT vs ext4
https://claude.ai/code/session_017WJtGcE5jjerAQCUBWUE3H
This commit is contained in:
@@ -85,52 +85,59 @@ docker compose down # stop
|
|||||||
## Installing from a USB thumb drive
|
## Installing from a USB thumb drive
|
||||||
|
|
||||||
Carry the repo on a USB stick and run setup on any fresh Ubuntu machine —
|
Carry the repo on a USB stick and run setup on any fresh Ubuntu machine —
|
||||||
no internet needed for the repo itself. The USB includes a double-click launcher
|
no internet needed for the repo itself.
|
||||||
so you don't need to open a terminal at all.
|
|
||||||
|
|
||||||
### 1 — Clone the repo onto the USB (on your main machine)
|
### 1 — Put the repo on the USB (on your main machine)
|
||||||
|
|
||||||
Plug in the USB, then run:
|
Open a terminal in the repo and clone onto the USB from there. The file
|
||||||
|
manager shows the USB in the sidebar — right-click it → **Open in Terminal**,
|
||||||
|
then:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Find where Ubuntu mounted the USB
|
git clone https://github.com/outis1one/ubuntu-post-install.git .
|
||||||
USB=$(lsblk -o MOUNTPOINT,RM --noheadings | awk '$2=="1" && $1!="" {print $1}' | head -1)
|
|
||||||
echo "USB mounted at: $USB"
|
|
||||||
|
|
||||||
# Clone directly onto it
|
|
||||||
git clone https://github.com/outis1one/ubuntu-post-install.git \
|
|
||||||
"$USB/ubuntu-post-install"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Or if you already have a local clone, copy it across:
|
Or copy an existing clone:
|
||||||
```bash
|
```bash
|
||||||
cp -r ~/ubuntu-post-install "$USB/ubuntu-post-install"
|
cp -r ~/ubuntu-post-install /path/to/usb/ubuntu-post-install
|
||||||
```
|
```
|
||||||
|
|
||||||
Keep it up to date before each use:
|
Keep it up to date before each use:
|
||||||
```bash
|
```bash
|
||||||
git -C "$USB/ubuntu-post-install" pull
|
git pull
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2 — Enable right-click "Open in Terminal" (once per machine)
|
### 2 — Run on the target machine (two ways)
|
||||||
|
|
||||||
On a fresh Ubuntu Desktop install the Nautilus terminal extension so you can
|
**Option A — Right-click → Open in Terminal** (quickest)
|
||||||
right-click any folder on the USB and open a terminal there:
|
|
||||||
|
In the Files app, navigate to the USB → right-click the
|
||||||
|
`ubuntu-post-install` folder → **Open in Terminal**, then:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo apt install nautilus-extension-gnome-terminal
|
sudo ./setup.sh
|
||||||
nautilus -q # restart Files to pick it up
|
|
||||||
```
|
```
|
||||||
|
|
||||||
On Ubuntu 24.04+ this is often already present — right-click a folder to check.
|
If "Open in Terminal" isn't in the menu, install it once:
|
||||||
|
```bash
|
||||||
|
sudo apt install nautilus-extension-gnome-terminal && nautilus -q
|
||||||
|
```
|
||||||
|
|
||||||
|
**Option B — Double-click `bootstrap.sh`**
|
||||||
|
|
||||||
|
Right-click `bootstrap.sh` → **Properties** → turn on **Executable as Program**.
|
||||||
|
After that, double-clicking it asks *"Run in Terminal?"* — click that, and it
|
||||||
|
prompts for your sudo password and starts the wizard automatically.
|
||||||
|
(The script re-elevates itself with sudo so you don't need to type anything
|
||||||
|
extra in the terminal.)
|
||||||
|
|
||||||
### Notes
|
### Notes
|
||||||
|
|
||||||
- Everything the wizard installs (Docker containers, service configs) goes to
|
- Everything the wizard installs goes to `~/docker/` on the **target machine's
|
||||||
`~/docker/` on the **target machine** — only the scripts live on the USB.
|
disk** — only the setup scripts live on the USB.
|
||||||
- **exFAT vs ext4:** exFAT works on macOS and Windows too (handy for updating
|
- **exFAT vs ext4:** exFAT works on macOS and Windows too (handy for updating
|
||||||
the repo from any machine). ext4 is Linux-only but preserves execute
|
the repo from any machine). ext4 is Linux-only but preserves the executable
|
||||||
permissions so you never need the `chmod` step above.
|
bit on `bootstrap.sh` so the Properties step above is only needed once.
|
||||||
|
|
||||||
## Compatibility
|
## Compatibility
|
||||||
|
|
||||||
|
|||||||
@@ -4,12 +4,20 @@
|
|||||||
# One command to paste into a new Ubuntu box:
|
# One command to paste into a new Ubuntu box:
|
||||||
# curl -fsSL https://raw.githubusercontent.com/outis1one/ubuntu-post-install/main/bootstrap.sh | sudo bash
|
# curl -fsSL https://raw.githubusercontent.com/outis1one/ubuntu-post-install/main/bootstrap.sh | sudo bash
|
||||||
#
|
#
|
||||||
|
# Or double-click it in the file manager ("Run in Terminal") — it will
|
||||||
|
# prompt for your sudo password automatically.
|
||||||
|
#
|
||||||
# What it does:
|
# What it does:
|
||||||
# 1. Installs git if missing (the only hard dependency)
|
# 1. Installs git if missing (the only hard dependency)
|
||||||
# 2. Clones (or updates) the repo to ~/ubuntu-post-install
|
# 2. Clones (or updates) the repo to ~/ubuntu-post-install
|
||||||
# 3. Launches the interactive setup wizard
|
# 3. Launches the interactive setup wizard
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
|
|
||||||
|
# Self-elevate: if not root, re-exec under sudo so a plain double-click works.
|
||||||
|
if [ "${EUID:-$(id -u)}" -ne 0 ]; then
|
||||||
|
exec sudo bash "$0" "$@"
|
||||||
|
fi
|
||||||
|
|
||||||
REPO_URL="https://github.com/outis1one/ubuntu-post-install.git"
|
REPO_URL="https://github.com/outis1one/ubuntu-post-install.git"
|
||||||
DEST="${HOME:-/root}/ubuntu-post-install"
|
DEST="${HOME:-/root}/ubuntu-post-install"
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user