From 767724414332badda25e16f5c48cbb2f94704868 Mon Sep 17 00:00:00 2001 From: Anto01 Date: Wed, 14 Jan 2026 10:59:36 -0500 Subject: [PATCH] Add Precision consultant laptop setup guide --- docs/PRECISION-CONSULTANT-SETUP.md | 607 +++++++++++++++++++++++++++++ 1 file changed, 607 insertions(+) create mode 100644 docs/PRECISION-CONSULTANT-SETUP.md diff --git a/docs/PRECISION-CONSULTANT-SETUP.md b/docs/PRECISION-CONSULTANT-SETUP.md new file mode 100644 index 0000000..e7cc532 --- /dev/null +++ b/docs/PRECISION-CONSULTANT-SETUP.md @@ -0,0 +1,607 @@ +# Precision Laptop Setup - Atomaste Consultant + +> **Laptop:** Dell Precision +> **Purpose:** Engineering workstation for consultant +> **Account:** engineer@atomaste.ca +> **Created:** January 2026 + +--- + +## Quick Reference + +| Service | URL / Value | +|---------|-------------| +| **Gitea (Git)** | http://100.80.199.40:3000 | +| **Polisher Repo** | http://100.80.199.40:3000/Atomaste/P09-Fullum-Polisher-Overhaul | +| **Seafile** | http://100.80.199.40:8083 | +| **dalidou IP (Tailscale)** | 100.80.199.40 | +| **NX License Server** | 28000@100.80.199.40 | +| **Email IMAP** | imap.hostinger.com:993 (SSL) | +| **Email SMTP** | smtp.hostinger.com:465 (SSL) | + +--- + +## Table of Contents + +1. [Fresh Windows Install](#1-fresh-windows-install) +2. [Initial Windows Configuration](#2-initial-windows-configuration) +3. [Tailscale Setup](#3-tailscale-setup) +4. [Bitwarden Setup](#4-bitwarden-setup) +5. [Email Setup](#5-email-setup) +6. [NordVPN Setup](#6-nordvpn-setup) +7. [Git & Git LFS Setup](#7-git--git-lfs-setup) +8. [Seafile Setup](#8-seafile-setup) +9. [Gitea Access Setup](#9-gitea-access-setup) +10. [NX Setup](#10-nx-setup) +11. [SolidWorks Setup](#11-solidworks-setup) +12. [Final Verification](#12-final-verification) + +--- + +## 1. Fresh Windows Install + +### Option A: Reset from Within Windows (Easiest) + +If Windows is still working: + +1. Go to **Settings** → **System** → **Recovery** +2. Click **Reset this PC** +3. Choose **Remove everything** +4. Select **Cloud download** (gets fresh Windows from Microsoft) +5. Choose **Clean the drive** (secure wipe) +6. Click **Reset** +7. Wait for reinstall to complete + +### Option B: USB Install (If Windows Won't Boot) + +#### Prerequisites + +- [ ] USB drive (8GB+) with Windows 11 installation media +- [ ] Windows 11 Pro product key (if not embedded in BIOS) + +#### Create Windows Installation USB + +1. Download Windows 11 Media Creation Tool from Microsoft +2. Create bootable USB + +#### Install Windows + +1. Boot from USB (F12 during startup on Dell) +2. Select **Windows 11 Pro** +3. Choose **Custom: Install Windows only** +4. Delete all existing partitions +5. Select unallocated space and click Next +6. Wait for installation to complete + +### Initial Setup (OOBE) + +1. **Region:** Canada +2. **Keyboard:** US or Canadian French (as preferred) +3. **Network:** Connect to WiFi +4. **Account Setup:** + - Select **Set up for work or school** + - Click **Sign-in options** → **Domain join instead** + - Create local admin account: + - **Username:** `Atomaste` + - **Password:** (store in Bitwarden) + - Security questions: Set 3 questions +5. **Privacy settings:** Disable all telemetry options +6. Complete setup + +### Post-Install + +```powershell +# Run as Administrator + +# Rename computer +Rename-Computer -NewName "PRECISION-ATOMASTE" -Restart +``` + +--- + +## 2. Initial Windows Configuration + +### Windows Updates + +1. Settings → Windows Update → Check for updates +2. Install all updates +3. Restart as needed +4. Repeat until no updates remain + +### Install Dell Drivers + +1. Download **Dell Command Update** from dell.com/support +2. Run and install all recommended drivers +3. Restart + +### Install Essential Software + +```powershell +# Run as Administrator +# Install winget apps + +winget install Microsoft.PowerShell +winget install Microsoft.WindowsTerminal +winget install 7zip.7zip +winget install Notepad++.Notepad++ +``` + +--- + +## 3. Tailscale Setup + +### Install Tailscale + +```powershell +winget install Tailscale.Tailscale +``` + +### Configure + +1. Open Tailscale from system tray +2. Click **Log in** +3. **IMPORTANT:** Log in with Antoine's Tailscale account (not a new one) +4. Approve the device in Tailscale admin console if prompted + +### Verify Connection + +```powershell +# Test connection to dalidou +ping 100.80.199.40 + +# Should respond - this is the home server +``` + +### Tailscale Admin Notes + +- Device will appear in Tailscale admin console +- Can be renamed to "Precision-Consultant" for clarity +- Access can be revoked anytime from admin console + +--- + +## 4. Bitwarden Setup + +### Create Bitwarden Account for Consultant + +1. Go to https://vault.bitwarden.com +2. Create account with `engineer@atomaste.ca` +3. Set a strong master password +4. Store master password securely (give to consultant separately) + +### Set Up Bitwarden Organization (Antoine's Side) + +1. Log into your Bitwarden account +2. Go to Organizations → Create Organization (free tier) +3. Name: `Atomaste` +4. Invite `engineer@atomaste.ca` as a member + +### Create Shared Collection + +1. In the organization, create collection: `Consultant-Shared` +2. Add these credentials to the collection: + - NordVPN login + - Gitea `engineer` account + - Seafile `engineer` account + - Any project-specific passwords + +### Install on Precision + +```powershell +winget install Bitwarden.Bitwarden +``` + +1. Open Bitwarden +2. Log in with `engineer@atomaste.ca` +3. Accept organization invitation +4. Shared passwords will appear in the vault + +--- + +## 5. Email Setup + +### Reserve Email on Hostinger + +1. Log into Hostinger control panel +2. Go to Emails → Create email account +3. Create: `engineer@atomaste.ca` +4. Set password (store in Bitwarden shared collection) + +### Install Thunderbird + +```powershell +winget install Mozilla.Thunderbird +``` + +### Configure Thunderbird + +1. Open Thunderbird +2. Enter: + - Name: `Atomaste Engineer` + - Email: `engineer@atomaste.ca` + - Password: (from Bitwarden) +3. Thunderbird should auto-detect Hostinger settings +4. If auto-detect fails, click **Configure manually** and use: + +| Setting | Incoming (IMAP) | Outgoing (SMTP) | +|---------|-----------------|-----------------| +| Server | `imap.hostinger.com` | `smtp.hostinger.com` | +| Port | `993` | `465` | +| Security | SSL/TLS | SSL/TLS | +| Authentication | Normal password | Normal password | +| Username | `engineer@atomaste.ca` | `engineer@atomaste.ca` | + +5. Click **Re-test** to verify +6. Click **Done** + +--- + +## 6. NordVPN Setup + +### Install NordVPN + +```powershell +winget install NordVPN.NordVPN +``` + +### Configure + +1. Open NordVPN +2. Log in with credentials from Bitwarden shared collection +3. Connect to preferred server (Canada recommended) +4. Enable auto-connect on startup (optional) + +--- + +## 7. Git & Git LFS Setup + +### Install Git + +```powershell +winget install Git.Git +``` + +Close and reopen terminal after installation. + +### Run Setup Script + +```powershell +# Navigate to the scripts folder (after cloning or copying) +cd C:\path\to\SERVtomaste\scripts +.\windows-setup.ps1 +``` + +Or manually: + +```powershell +# Install Git LFS +winget install GitHub.GitLFS + +# Initialize Git LFS +git lfs install + +# Configure for large files +git config --global http.postBuffer 524288000 +git config --global credential.helper manager + +# Set user identity +git config --global user.name "Atomaste Engineer" +git config --global user.email "engineer@atomaste.ca" +``` + +--- + +## 8. Seafile Setup + +### Create Seafile Account (Antoine's Side - on dalidou) + +1. Go to http://100.80.199.40:8083 (via Tailscale) +2. Log in as admin +3. System Admin → Users → Add User + - Email: `engineer@atomaste.ca` + - Password: (store in Bitwarden) + +### Share Project Library + +1. Navigate to the Atomaste project library +2. Click Share → Share to user +3. Enter: `engineer@atomaste.ca` +4. Permission: Read-Write (or Read-Only as needed) + +### Install SeaDrive on Precision + +1. Download SeaDrive from https://www.seafile.com/en/download/ +2. Install SeaDrive (not Seafile Client - SeaDrive is better for selective sync) +3. Configure: + - Server: `http://100.80.199.40:8083` + - Email: `engineer@atomaste.ca` + - Password: (from Bitwarden) +4. Choose drive letter (e.g., `S:\`) +5. Only shared libraries will appear + +### Verify + +- Open File Explorer +- Navigate to `S:\` drive +- Should see only the shared Atomaste project folder + +--- + +## 9. Gitea Access Setup + +### Create Gitea Account (Antoine's Side - on dalidou) + +1. Go to http://100.80.199.40:3000 +2. Site Administration → User Accounts → Create User + - Username: `engineer` + - Email: `engineer@atomaste.ca` + - Password: (store in Bitwarden) + +### Grant Repository Access + +1. Navigate to: http://100.80.199.40:3000/Atomaste/P09-Fullum-Polisher-Overhaul +2. Settings → Collaborators +3. Add `engineer` with Write access + +### Clone Repository on Precision + +```powershell +# Create CAD folder +mkdir C:\CAD +cd C:\CAD + +# Clone the project +git clone http://100.80.199.40:3000/Atomaste/P09-Fullum-Polisher-Overhaul.git + +# Enter credentials when prompted (from Bitwarden) +``` + +### Verify Clone + +```powershell +cd P09-Fullum-Polisher-Overhaul +git lfs pull +git status +``` + +### Included Workflow Scripts + +The repository contains simple batch scripts for non-git users: + +| Script | Purpose | +|--------|---------| +| `SAVE-WORK.bat` | Commits and pushes all changes to server | +| `GET-LATEST.bat` | Pulls latest changes from server | +| `CHECK-STATUS.bat` | Shows what files have changed locally | + +**Daily workflow for consultant:** +1. Start of day: Double-click `GET-LATEST.bat` +2. Do your work in SolidWorks/NX +3. End of day: Double-click `SAVE-WORK.bat`, enter a description + +--- + +## 10. NX Setup + +### Install NX + +1. Download NX installer from Siemens or use provided installation media +2. Run installer +3. Follow installation wizard +4. Do NOT configure licensing during install (we'll do it after) + +### Configure License Server + +1. Open **System Properties** (Win + R → `sysdm.cpl`) +2. Click **Advanced** → **Environment Variables** +3. Under **System variables**, click **New** +4. Add: + - **Variable name:** `SPLM_LICENSE_SERVER` + - **Variable value:** `28000@100.80.199.40` + +5. Click OK to save + +### Verify License + +1. Open **Siemens Licensing Tool** (installed with NX) +2. Go to Environment Settings +3. Verify connection status shows **Successful** + +### Test NX + +1. Launch NX +2. Should open without license errors +3. Create a simple part to verify functionality + +--- + +## 11. SolidWorks Setup + +### Install SolidWorks + +1. Download SolidWorks 2026 installer +2. Run Installation Manager +3. Select components: + - SolidWorks + - SolidWorks PDM (if needed) + - eDrawings +4. Complete installation + +### Activate License + +1. Launch SolidWorks +2. Help → Activate Licenses +3. Use standalone license activation +4. Enter license key from LICENSE_DETAILS document + +### Apply Privacy Lockdown + +**IMPORTANT:** Run this after first SolidWorks launch. + +```powershell +# Run as Administrator +cd "C:\path\to\SERVtomaste\Solidworks Licenses\scripts" + +# Preview changes first (recommended) +.\00-install-privacy-lockdown.ps1 -DryRun + +# Apply lockdown +.\00-install-privacy-lockdown.ps1 + +# Verify +.\05-verify-lockdown.ps1 -Detailed +``` + +### Verify SolidWorks + +1. Launch SolidWorks +2. Create a simple part +3. Verify no license errors +4. Check that telemetry is blocked (no update prompts) + +--- + +## 12. Final Verification + +### Checklist + +| Component | Test | Status | +|-----------|------|--------| +| Windows | Boots normally, all drivers working | [ ] | +| Tailscale | `ping 100.80.199.40` succeeds | [ ] | +| Bitwarden | Can access shared passwords | [ ] | +| Email | Can send/receive from engineer@atomaste.ca | [ ] | +| NordVPN | Can connect to VPN | [ ] | +| Git | `git --version` works | [ ] | +| Git LFS | `git lfs version` works | [ ] | +| Seafile | S:\ drive shows shared folder | [ ] | +| Gitea | Can push/pull from Polisher-Project | [ ] | +| NX | Opens without license error | [ ] | +| SolidWorks | Opens and privacy lockdown active | [ ] | + +### Test Workflow + +1. **Seafile:** Create a test file in S:\, verify it syncs +2. **Git workflow test:** + - Open `C:\CAD\P09-Fullum-Polisher-Overhaul` + - Run `GET-LATEST.bat` - should show "up to date" + - Create a test file (e.g., `test.txt`) + - Run `SAVE-WORK.bat` - enter "Test commit" + - Verify it pushes successfully + - Delete test file, run `SAVE-WORK.bat` again +3. **NX:** Open a part from the project, make an edit, save +4. **SolidWorks:** Open a part, make an edit, save + +--- + +## Credentials Summary + +| Service | Username | Password Location | +|---------|----------|-------------------| +| Windows (local) | Atomaste | Bitwarden - personal | +| Tailscale | (Antoine's account) | N/A | +| Bitwarden | engineer@atomaste.ca | Given separately | +| Email | engineer@atomaste.ca | Bitwarden - shared | +| NordVPN | (Antoine's account) | Bitwarden - shared | +| Seafile | engineer@atomaste.ca | Bitwarden - shared | +| Gitea | engineer | Bitwarden - shared | + +--- + +## Troubleshooting + +### Can't Connect to dalidou Services + +1. Check Tailscale is connected (green icon in system tray) +2. Try `ping 100.80.199.40` +3. If Tailscale disconnected, click icon → Connect + +### NX License Error + +1. Verify environment variable is set correctly +2. Check Tailscale connection +3. Run Siemens Licensing Tool to diagnose + +### SolidWorks License Error + +1. May need to transfer license from another machine first +2. Help → Transfer License → check status + +### Seafile Not Syncing + +1. Check SeaDrive is running (system tray) +2. Verify Tailscale connection +3. Try logging out and back in + +### Git Push Fails + +1. Check credentials are correct +2. Verify Tailscale connection +3. Try: `git config --global credential.helper manager` then retry + +--- + +## Handoff to Consultant + +When handing over the laptop: + +1. Provide Bitwarden master password (verbally or secure channel) +2. Walk through the Git workflow: + - Show `C:\CAD\P09-Fullum-Polisher-Overhaul` folder + - Demo `GET-LATEST.bat` - "Run this at start of day" + - Demo `SAVE-WORK.bat` - "Run this when done working" + - Demo `CHECK-STATUS.bat` - "Shows what files you changed" +3. Show Tailscale icon in system tray (should stay green/connected) +4. Explain: + - **Seafile (S: drive):** For documents, references, non-CAD files + - **Git (C:\CAD):** For CAD files - use the .bat scripts +5. Show Thunderbird for email +6. Provide contact info for technical support + +### Quick Reference Card for Consultant + +``` +============================================ +DAILY WORKFLOW - POLISHER PROJECT +============================================ + +START OF DAY: + 1. Check Tailscale is connected (green icon) + 2. Open C:\CAD\P09-Fullum-Polisher-Overhaul + 3. Double-click GET-LATEST.bat + +DO YOUR WORK: + - Edit files in SolidWorks/NX as normal + - Save files as normal + +END OF DAY: + 1. Double-click SAVE-WORK.bat + 2. Type a short description of your changes + 3. Press Enter + +PROBLEMS? + - Contact Antoine +============================================ +``` + +--- + +## Revoking Access (When Project Ends) + +1. **Tailscale:** Remove device from admin console +2. **Bitwarden:** Remove from organization +3. **Gitea:** Remove collaborator from repo +4. **Seafile:** Unshare library +5. **SolidWorks:** Transfer license back to your machine +6. **Email:** Disable or delete engineer@atomaste.ca + +--- + +## Document History + +| Date | Change | +|------|--------| +| 2026-01-14 | Added workflow scripts, updated Gitea repo URL, added quick reference | +| 2026-01-14 | Added Reset PC option for fresh install | +| 2026-01-14 | Added detailed Thunderbird manual config | +| 2026-01-13 | Initial document created |