Antoine/SERVtomaste
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add Precision consultant laptop setup guide

Browse Source
This commit is contained in:
Anto01
2026-01-14 10:59:36 -05:00
parent 57bcfa4a9a
commit 7677244143
1 changed files with 607 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

607
docs/PRECISION-CONSULTANT-SETUP.md Normal file
View File

@@ -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 |