|
|
@@ -93,13 +93,13 @@ Installs BamBuddy with Python virtual environment and optional systemd/launchd s
|
|
|
```
|
|
|
### `windows-installer.ps1` (Windows)
|
|
|
|
|
|
-Windows PowerShell:
|
|
|
+Windows PowerShell (run as Administrator — the installer self-elevates via UAC if not):
|
|
|
|
|
|
```powershell
|
|
|
powershell -ExecutionPolicy Bypass -Command "iwr -useb https://raw.githubusercontent.com/maziggy/bambuddy/main/install/windows-installer.ps1 -OutFile windows-installer.ps1; .\windows-installer.ps1"
|
|
|
-
|
|
|
```
|
|
|
-> Installs Bambuddy natively on Windows using Git, Python, a virtual environment, and optional NSSM Windows Service registration.
|
|
|
+
|
|
|
+> Installs Bambuddy natively on Windows using Git, Python, a virtual environment, and optional NSSM Windows Service registration. See the [Windows Installer Guide](https://wiki.bambuddy.cool/getting-started/windows-installer/) for full parameter reference.
|
|
|
|
|
|
**Parameters:**
|
|
|
```powershell
|
|
|
@@ -233,6 +233,15 @@ launchctl load ~/Library/LaunchAgents/com.bambuddy.app.plist # Start
|
|
|
launchctl unload ~/Library/LaunchAgents/com.bambuddy.app.plist # Stop
|
|
|
```
|
|
|
|
|
|
+**Windows (NSSM service):**
|
|
|
+```powershell
|
|
|
+Get-Service Bambuddy # Check status
|
|
|
+Start-Service Bambuddy # Start
|
|
|
+Stop-Service Bambuddy # Stop
|
|
|
+Restart-Service Bambuddy # Restart
|
|
|
+Get-Content "C:\Bambuddy\bambuddy-runtime.log" -Tail 100 -Wait # View logs
|
|
|
+```
|
|
|
+
|
|
|
**Docker:**
|
|
|
```bash
|
|
|
docker compose ps # Check status
|
|
|
@@ -288,6 +297,13 @@ git pull
|
|
|
docker compose up -d --build
|
|
|
```
|
|
|
|
|
|
+**Windows (native):** rerun the installer; it detects the existing checkout and offers `git pull`, leaving `INSTALL_DIR\data` and `INSTALL_DIR\logs` untouched. Stop the service first if it is registered:
|
|
|
+```powershell
|
|
|
+Stop-Service Bambuddy
|
|
|
+.\windows-installer.ps1 -Yes
|
|
|
+Start-Service Bambuddy
|
|
|
+```
|
|
|
+
|
|
|
---
|
|
|
|
|
|
## Troubleshooting
|
|
|
@@ -318,6 +334,22 @@ Choose a different port during installation or stop the conflicting service:
|
|
|
sudo lsof -i :8000 # Linux/macOS
|
|
|
```
|
|
|
|
|
|
+```powershell
|
|
|
+# Windows
|
|
|
+Get-NetTCPConnection -LocalPort 8000 -State Listen
|
|
|
+```
|
|
|
+
|
|
|
+### Windows: Service Won't Start
|
|
|
+Test the start script manually first:
|
|
|
+```powershell
|
|
|
+powershell.exe -ExecutionPolicy Bypass -File "C:\Bambuddy\Start-Bambuddy.ps1"
|
|
|
+```
|
|
|
+
|
|
|
+Then check the NSSM runtime logs:
|
|
|
+```powershell
|
|
|
+Get-Content "C:\Bambuddy\bambuddy-runtime-error.log" -Tail 100
|
|
|
+```
|
|
|
+
|
|
|
---
|
|
|
|
|
|
## Requirements
|