Add USB thumb drive install docs and double-click launcher
README: rewrite USB section with three steps: 1. Auto-detect USB mount point and clone repo onto it 2. Install nautilus-extension-gnome-terminal for right-click "Open in Terminal" 3. Double-click "Run Setup.desktop" to launch wizard with sudo (no terminal needed) Run Setup.desktop: launcher file included in the repo so it's present on the USB automatically. Uses %k to find its own location, cds to that directory, and runs sudo ./setup.sh in a terminal window. https://claude.ai/code/session_017WJtGcE5jjerAQCUBWUE3H
This commit is contained in:
@@ -84,60 +84,67 @@ docker compose down # stop
|
|||||||
|
|
||||||
## Installing from a USB thumb drive
|
## Installing from a USB thumb drive
|
||||||
|
|
||||||
You can carry the repo on a USB stick and run setup directly from it on any
|
Carry the repo on a USB stick and run setup on any fresh Ubuntu machine —
|
||||||
fresh Ubuntu machine — no git, no internet needed for the repo itself.
|
no internet needed for the repo itself. The USB includes a double-click launcher
|
||||||
|
so you don't need to open a terminal at all.
|
||||||
|
|
||||||
### 1 — Put the repo on the USB drive (on your main machine)
|
### 1 — Clone the repo onto the USB (on your main machine)
|
||||||
|
|
||||||
Format the USB as ext4 or exFAT, then clone directly onto it:
|
Plug in the USB, then run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Find your USB device
|
# Find where Ubuntu mounted the USB
|
||||||
lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINT
|
USB=$(lsblk -o MOUNTPOINT,RM --noheadings | awk '$2=="1" && $1!="" {print $1}' | head -1)
|
||||||
|
echo "USB mounted at: $USB"
|
||||||
|
|
||||||
# Clone the repo onto the USB (adjust mount path to match yours)
|
# Clone directly onto it
|
||||||
git clone https://github.com/outis1one/ubuntu-post-install.git \
|
git clone https://github.com/outis1one/ubuntu-post-install.git \
|
||||||
/media/$USER/YOURUSBNAME/ubuntu-post-install
|
"$USB/ubuntu-post-install"
|
||||||
```
|
```
|
||||||
|
|
||||||
Or copy an existing clone:
|
Or if you already have a local clone, copy it across:
|
||||||
```bash
|
```bash
|
||||||
cp -r ~/ubuntu-post-install /media/$USER/YOURUSBNAME/ubuntu-post-install
|
cp -r ~/ubuntu-post-install "$USB/ubuntu-post-install"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2 — Run setup on the target machine
|
Keep it up to date before each use:
|
||||||
|
```bash
|
||||||
|
git -C "$USB/ubuntu-post-install" pull
|
||||||
|
```
|
||||||
|
|
||||||
Plug the USB in. Ubuntu auto-mounts it under `/media/<username>/` or
|
### 2 — Enable right-click "Open in Terminal" (once per machine)
|
||||||
`/run/media/<username>/`. Find it:
|
|
||||||
|
On a fresh Ubuntu Desktop install the Nautilus terminal extension so you can
|
||||||
|
right-click any folder on the USB and open a terminal there:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
ls /media/$USER/ # Ubuntu Desktop
|
sudo apt install nautilus-extension-gnome-terminal
|
||||||
ls /run/media/$USER/ # some distros / servers
|
nautilus -q # restart Files to pick it up
|
||||||
lsblk -o NAME,MOUNTPOINT # always works
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Then run setup directly from the USB:
|
On Ubuntu 24.04+ this is often already present — right-click a folder to check.
|
||||||
|
|
||||||
|
### 3 — Double-click to run (no terminal needed)
|
||||||
|
|
||||||
|
The repo includes `Run Setup.desktop` — a launcher that opens a terminal and
|
||||||
|
runs the wizard with sudo when you double-click it in the Files app.
|
||||||
|
|
||||||
|
First time on a new machine: right-click the file → **Properties** →
|
||||||
|
**Executable as Program** toggle on (or tick "Allow executing file as program").
|
||||||
|
After that, double-clicking it prompts for your sudo password and starts the wizard.
|
||||||
|
|
||||||
|
If the toggle isn't there, enable it from the terminal once:
|
||||||
```bash
|
```bash
|
||||||
sudo /media/$USER/YOURUSBNAME/ubuntu-post-install/setup.sh
|
chmod +x /path/to/usb/ubuntu-post-install/Run\ Setup.desktop
|
||||||
```
|
```
|
||||||
|
|
||||||
Everything the wizard installs (Docker containers, service configs) still goes
|
### Notes
|
||||||
to `~/docker/` on the **target machine's disk** — only the setup scripts live
|
|
||||||
on the USB.
|
|
||||||
|
|
||||||
### Tips
|
- Everything the wizard installs (Docker containers, service configs) goes to
|
||||||
|
`~/docker/` on the **target machine** — only the scripts live on the USB.
|
||||||
- **Keep it updated:** `git pull` inside the USB copy before each use to get
|
- **exFAT vs ext4:** exFAT works on macOS and Windows too (handy for updating
|
||||||
the latest service scripts.
|
the repo from any machine). ext4 is Linux-only but preserves execute
|
||||||
- **exFAT vs ext4:** exFAT works on macOS and Windows too (easier to update the
|
permissions so you never need the `chmod` step above.
|
||||||
repo from any machine). ext4 is Linux-only but preserves file permissions —
|
|
||||||
either works fine for running bash scripts.
|
|
||||||
- **Permissions:** If the scripts aren't executable after copying, fix with:
|
|
||||||
```bash
|
|
||||||
chmod +x /media/$USER/YOURUSBNAME/ubuntu-post-install/setup.sh
|
|
||||||
chmod +x /media/$USER/YOURUSBNAME/ubuntu-post-install/services/*.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
## Compatibility
|
## Compatibility
|
||||||
|
|
||||||
|
|||||||
Executable
+9
@@ -0,0 +1,9 @@
|
|||||||
|
[Desktop Entry]
|
||||||
|
Version=1.0
|
||||||
|
Type=Application
|
||||||
|
Name=Ubuntu Post-Install Setup
|
||||||
|
Comment=Run the post-install setup wizard with sudo
|
||||||
|
Exec=bash -c 'cd "$(dirname "$1")" && sudo ./setup.sh; echo; read -rp "Done — press Enter to close" _' -- %k
|
||||||
|
Terminal=true
|
||||||
|
Icon=utilities-terminal
|
||||||
|
Categories=System;
|
||||||
Reference in New Issue
Block a user