clonebox 0.1.12__tar.gz → 0.1.14__tar.gz

{clonebox-0.1.12/src/clonebox.egg-info → clonebox-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.12
+Version: 0.1.14
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -235,6 +235,9 @@ clonebox open . --user
 
 # 6. Stop VM when done
 clonebox stop . --user
+
+# 7. Delete VM if needed
+clonebox delete . --user --yes
 ```
 
 ### Development Environment with Browser Profiles
@@ -273,24 +276,33 @@ clonebox test . --user --verbose
 # ✅ Health check triggered
 ```
 
-### VM Health Monitoring
+### VM Health Monitoring and Mount Validation
 
 ```bash
-# Check overall status
+# Check overall status including mount validation
 clonebox status . --user
 
-# Output:
-# 📊 Checking VM status: clone-clonebox
-# ✅ VM State: running
-# ✅ VM has network access
-# ☁️ Cloud-init: Still running (packages installing)
-# 🏥 Health Check Status... ⏳ Health check not yet run
-
-# Trigger health check
+# Output shows:
+# 📊 VM State: running
+# 🔍 Network and IP address
+# ☁️ Cloud-init: Complete
+# 💾 Mount Points status table:
+#    ┌─────────────────────────┬──────────────┬────────┐
+#    │ Guest Path              │ Status       │ Files  │
+#    ├─────────────────────────┼──────────────┼────────┤
+#    │ /home/ubuntu/Downloads  │ ✅ Mounted   │ 199    │
+#    │ /home/ubuntu/Documents  │ ❌ Not mounted│ ?     │
+#    │ ~/.config/JetBrains     │ ✅ Mounted   │ 45     │
+#    └─────────────────────────┴──────────────┴────────┘
+#    12/14 mounts active
+# 🏥 Health Check Status: OK
+
+# Trigger full health check
 clonebox status . --user --health
 
-# View detailed health report in VM:
-# cat /var/log/clonebox-health.log
+# If mounts are missing, remount or rebuild:
+# In VM: sudo mount -a
+# Or rebuild: clonebox clone . --user --run --replace
 ```
 
 ### Export/Import Workflow
@@ -578,15 +590,17 @@ clonebox clone . --network auto
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
-| `clonebox stop <name>` | Stop a VM (graceful shutdown) |
-| `clonebox stop -f <name>` | Force stop a VM |
-| `clonebox delete <name>` | Delete VM and storage |
+| `clonebox stop .` | Stop VM from `.clonebox.yaml` in current dir |
+| `clonebox stop . -f` | Force stop VM |
+| `clonebox delete .` | Delete VM from `.clonebox.yaml` in current dir |
+| `clonebox delete . --yes` | Delete VM without confirmation |
 | `clonebox list` | List all VMs |
 | `clonebox detect` | Show detected services/apps/paths |
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
-| `clonebox status . --user` | Check VM health, cloud-init status, and IP address |
+| `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
+| `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration and validate all settings |
 | `clonebox export . --user` | Export VM for migration to another workstation |
 | `clonebox export . --user --include-data` | Export VM with browser profiles and configs |
@@ -665,22 +679,57 @@ sudo apt install virt-viewer
 virt-viewer --connect qemu:///session <vm-name>
 ```
 
-### Browser Profiles Not Syncing
+### Browser Profiles and PyCharm Not Working
 
-If browser profiles or app data aren't available:
+If browser profiles or PyCharm configs aren't available, or you get permission errors:
 
-1. **Regenerate config with app data:**
-   ```bash
-   rm .clonebox.yaml
-   clonebox clone . --user --run --replace
-   ```
+**Root cause:** VM was created with old version without proper mount permissions.
 
-2. **Check mount permissions in VM:**
-   ```bash
-   # Verify mounts are accessible
-   ls -la ~/.config/google-chrome
-   ls -la ~/.mozilla/firefox
-   ```
+**Solution - Rebuild VM with latest fixes:**
+
+```bash
+# Stop and delete old VM
+clonebox stop . --user
+clonebox delete . --user --yes
+
+# Recreate VM with fixed permissions and app data mounts
+clonebox clone . --user --run --replace
+```
+
+**After rebuild, verify mounts in VM:**
+```bash
+# Check all mounts are accessible
+ls ~/.config/google-chrome      # Chrome profile
+ls ~/.mozilla/firefox           # Firefox profile  
+ls ~/.config/JetBrains         # PyCharm settings
+ls ~/Downloads                 # Downloads folder
+ls ~/Documents                 # Documents folder
+```
+
+**What changed in v0.1.12:**
+- All mounts use `uid=1000,gid=1000` for ubuntu user access
+- Both `paths` and `app_data_paths` are properly mounted
+- No sudo needed to access any shared directories
+
+### Mount Points Empty or Permission Denied
+
+If you get "must be superuser to use mount" error when accessing Downloads/Documents:
+
+**Solution:** VM was created with old mount configuration. Recreate VM:
+
+```bash
+# Stop and delete old VM
+clonebox stop . --user
+clonebox delete . --user --yes
+
+# Recreate with fixed permissions
+clonebox clone . --user --run --replace
+```
+
+**What was fixed:**
+- Mounts now use `uid=1000,gid=1000` so ubuntu user has access
+- No need for sudo to access shared directories
+- Applies to new VMs created after v0.1.12
 
 ### Mount Points Empty After Reboot
 
@@ -698,7 +747,7 @@ If shared directories appear empty after VM restart:
 
 3. **Verify access mode:**
    - VMs created with `accessmode="mapped"` allow any user to access mounts
-   - Older VMs used `accessmode="passthrough"` which preserves host UIDs
+   - Mount options include `uid=1000,gid=1000` for user access
 
 ## Advanced Usage
 
@@ -761,6 +810,160 @@ virsh --connect qemu:///session console clone-clonebox
 # Press Ctrl + ] to exit console
 ```
 
+## Exporting to Proxmox
+
+To use CloneBox VMs in Proxmox, you need to convert the qcow2 disk image to Proxmox format.
+
+### Step 1: Locate VM Disk Image
+
+```bash
+# Find VM disk location
+clonebox list
+
+# Check VM details for disk path
+virsh --connect qemu:///session dominfo clone-clonebox
+
+# Typical locations:
+# User session: ~/.local/share/libvirt/images/<vm-name>/<vm-name>.qcow2
+# System session: /var/lib/libvirt/images/<vm-name>/<vm-name>.qcow2
+```
+
+### Step 2: Export VM with CloneBox
+
+```bash
+# Export VM with all data (from current directory with .clonebox.yaml)
+clonebox export . --user --include-data -o clonebox-vm.tar.gz
+
+# Or export specific VM by name
+clonebox export safetytwin-vm --include-data -o safetytwin.tar.gz
+
+# Extract to get the disk image
+tar -xzf clonebox-vm.tar.gz
+cd clonebox-clonebox
+ls -la  # Should show disk.qcow2, vm.xml, etc.
+```
+
+### Step 3: Convert to Proxmox Format
+
+```bash
+# Install qemu-utils if not installed
+sudo apt install qemu-utils
+
+# Convert qcow2 to raw format (Proxmox preferred)
+qemu-img convert -f qcow2 -O raw disk.qcow2 vm-disk.raw
+
+# Or convert to qcow2 with compression for smaller size
+qemu-img convert -f qcow2 -O qcow2 -c disk.qcow2 vm-disk-compressed.qcow2
+```
+
+### Step 4: Transfer to Proxmox Host
+
+```bash
+# Using scp (replace with your Proxmox host IP)
+scp vm-disk.raw root@proxmox:/var/lib/vz/template/iso/
+
+# Or using rsync for large files
+rsync -avh --progress vm-disk.raw root@proxmox:/var/lib/vz/template/iso/
+```
+
+### Step 5: Create VM in Proxmox
+
+1. **Log into Proxmox Web UI**
+
+2. **Create new VM:**
+   - Click "Create VM"
+   - Enter VM ID and Name
+   - Set OS: "Do not use any media"
+
+3. **Configure Hardware:**
+   - **Hard Disk:** 
+     - Delete default disk
+     - Click "Add" → "Hard Disk"
+     - Select your uploaded image file
+     - Set Disk size (can be larger than image)
+     - Set Bus: "VirtIO SCSI"
+     - Set Cache: "Write back" for better performance
+
+4. **CPU & Memory:**
+   - Set CPU cores (match original VM config)
+   - Set Memory (match original VM config)
+
+5. **Network:**
+   - Set Model: "VirtIO (paravirtualized)"
+
+6. **Confirm:** Click "Finish" to create VM
+
+### Step 6: Post-Import Configuration
+
+1. **Start the VM in Proxmox**
+
+2. **Update network configuration:**
+   ```bash
+   # In VM console, update network interfaces
+   sudo nano /etc/netplan/01-netcfg.yaml
+   
+   # Example for Proxmox bridge:
+   network:
+     version: 2
+     renderer: networkd
+     ethernets:
+       ens18:  # Proxmox typically uses ens18
+         dhcp4: true
+   ```
+
+3. **Apply network changes:**
+   ```bash
+   sudo netplan apply
+   ```
+
+4. **Update mount points (if needed):**
+   ```bash
+   # Mount points will fail in Proxmox, remove them
+   sudo nano /etc/fstab
+   # Comment out or remove 9p mount entries
+   
+   # Reboot to apply changes
+   sudo reboot
+   ```
+
+### Alternative: Direct Import to Proxmox Storage
+
+If you have Proxmox with shared storage:
+
+```bash
+# On Proxmox host
+# Create a temporary directory
+mkdir /tmp/import
+
+# Copy disk directly to Proxmox storage (example for local-lvm)
+scp vm-disk.raw root@proxmox:/tmp/import/
+
+# On Proxmox host, create VM using CLI
+qm create 9000 --name clonebox-vm --memory 4096 --cores 4 --net0 virtio,bridge=vmbr0
+
+# Import disk to VM
+qm importdisk 9000 /tmp/import/vm-disk.raw local-lvm
+
+# Attach disk to VM
+qm set 9000 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-9000-disk-0
+
+# Set boot disk
+qm set 9000 --boot c --bootdisk scsi0
+```
+
+### Troubleshooting
+
+- **VM won't boot:** Check if disk format is compatible (raw is safest)
+- **Network not working:** Update network configuration for Proxmox's NIC naming
+- **Performance issues:** Use VirtIO drivers and set cache to "Write back"
+- **Mount errors:** Remove 9p mount entries from /etc/fstab as they won't work in Proxmox
+
+### Notes
+
+- CloneBox's bind mounts (9p filesystem) are specific to libvirt/QEMU and won't work in Proxmox
+- Browser profiles and app data exported with `--include-data` will be available in the VM disk
+- For shared folders in Proxmox, use Proxmox's shared folders or network shares instead
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) file.

{clonebox-0.1.12 → clonebox-0.1.14}/README.md

@@ -196,6 +196,9 @@ clonebox open . --user
 
 # 6. Stop VM when done
 clonebox stop . --user
+
+# 7. Delete VM if needed
+clonebox delete . --user --yes
 ```
 
 ### Development Environment with Browser Profiles
@@ -234,24 +237,33 @@ clonebox test . --user --verbose
 # ✅ Health check triggered
 ```
 
-### VM Health Monitoring
+### VM Health Monitoring and Mount Validation
 
 ```bash
-# Check overall status
+# Check overall status including mount validation
 clonebox status . --user
 
-# Output:
-# 📊 Checking VM status: clone-clonebox
-# ✅ VM State: running
-# ✅ VM has network access
-# ☁️ Cloud-init: Still running (packages installing)
-# 🏥 Health Check Status... ⏳ Health check not yet run
-
-# Trigger health check
+# Output shows:
+# 📊 VM State: running
+# 🔍 Network and IP address
+# ☁️ Cloud-init: Complete
+# 💾 Mount Points status table:
+#    ┌─────────────────────────┬──────────────┬────────┐
+#    │ Guest Path              │ Status       │ Files  │
+#    ├─────────────────────────┼──────────────┼────────┤
+#    │ /home/ubuntu/Downloads  │ ✅ Mounted   │ 199    │
+#    │ /home/ubuntu/Documents  │ ❌ Not mounted│ ?     │
+#    │ ~/.config/JetBrains     │ ✅ Mounted   │ 45     │
+#    └─────────────────────────┴──────────────┴────────┘
+#    12/14 mounts active
+# 🏥 Health Check Status: OK
+
+# Trigger full health check
 clonebox status . --user --health
 
-# View detailed health report in VM:
-# cat /var/log/clonebox-health.log
+# If mounts are missing, remount or rebuild:
+# In VM: sudo mount -a
+# Or rebuild: clonebox clone . --user --run --replace
 ```
 
 ### Export/Import Workflow
@@ -539,15 +551,17 @@ clonebox clone . --network auto
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
-| `clonebox stop <name>` | Stop a VM (graceful shutdown) |
-| `clonebox stop -f <name>` | Force stop a VM |
-| `clonebox delete <name>` | Delete VM and storage |
+| `clonebox stop .` | Stop VM from `.clonebox.yaml` in current dir |
+| `clonebox stop . -f` | Force stop VM |
+| `clonebox delete .` | Delete VM from `.clonebox.yaml` in current dir |
+| `clonebox delete . --yes` | Delete VM without confirmation |
 | `clonebox list` | List all VMs |
 | `clonebox detect` | Show detected services/apps/paths |
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
-| `clonebox status . --user` | Check VM health, cloud-init status, and IP address |
+| `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
+| `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration and validate all settings |
 | `clonebox export . --user` | Export VM for migration to another workstation |
 | `clonebox export . --user --include-data` | Export VM with browser profiles and configs |
@@ -626,22 +640,57 @@ sudo apt install virt-viewer
 virt-viewer --connect qemu:///session <vm-name>
 ```
 
-### Browser Profiles Not Syncing
+### Browser Profiles and PyCharm Not Working
 
-If browser profiles or app data aren't available:
+If browser profiles or PyCharm configs aren't available, or you get permission errors:
 
-1. **Regenerate config with app data:**
-   ```bash
-   rm .clonebox.yaml
-   clonebox clone . --user --run --replace
-   ```
+**Root cause:** VM was created with old version without proper mount permissions.
 
-2. **Check mount permissions in VM:**
-   ```bash
-   # Verify mounts are accessible
-   ls -la ~/.config/google-chrome
-   ls -la ~/.mozilla/firefox
-   ```
+**Solution - Rebuild VM with latest fixes:**
+
+```bash
+# Stop and delete old VM
+clonebox stop . --user
+clonebox delete . --user --yes
+
+# Recreate VM with fixed permissions and app data mounts
+clonebox clone . --user --run --replace
+```
+
+**After rebuild, verify mounts in VM:**
+```bash
+# Check all mounts are accessible
+ls ~/.config/google-chrome      # Chrome profile
+ls ~/.mozilla/firefox           # Firefox profile  
+ls ~/.config/JetBrains         # PyCharm settings
+ls ~/Downloads                 # Downloads folder
+ls ~/Documents                 # Documents folder
+```
+
+**What changed in v0.1.12:**
+- All mounts use `uid=1000,gid=1000` for ubuntu user access
+- Both `paths` and `app_data_paths` are properly mounted
+- No sudo needed to access any shared directories
+
+### Mount Points Empty or Permission Denied
+
+If you get "must be superuser to use mount" error when accessing Downloads/Documents:
+
+**Solution:** VM was created with old mount configuration. Recreate VM:
+
+```bash
+# Stop and delete old VM
+clonebox stop . --user
+clonebox delete . --user --yes
+
+# Recreate with fixed permissions
+clonebox clone . --user --run --replace
+```
+
+**What was fixed:**
+- Mounts now use `uid=1000,gid=1000` so ubuntu user has access
+- No need for sudo to access shared directories
+- Applies to new VMs created after v0.1.12
 
 ### Mount Points Empty After Reboot
 
@@ -659,7 +708,7 @@ If shared directories appear empty after VM restart:
 
 3. **Verify access mode:**
    - VMs created with `accessmode="mapped"` allow any user to access mounts
-   - Older VMs used `accessmode="passthrough"` which preserves host UIDs
+   - Mount options include `uid=1000,gid=1000` for user access
 
 ## Advanced Usage
 
@@ -722,6 +771,160 @@ virsh --connect qemu:///session console clone-clonebox
 # Press Ctrl + ] to exit console
 ```
 
+## Exporting to Proxmox
+
+To use CloneBox VMs in Proxmox, you need to convert the qcow2 disk image to Proxmox format.
+
+### Step 1: Locate VM Disk Image
+
+```bash
+# Find VM disk location
+clonebox list
+
+# Check VM details for disk path
+virsh --connect qemu:///session dominfo clone-clonebox
+
+# Typical locations:
+# User session: ~/.local/share/libvirt/images/<vm-name>/<vm-name>.qcow2
+# System session: /var/lib/libvirt/images/<vm-name>/<vm-name>.qcow2
+```
+
+### Step 2: Export VM with CloneBox
+
+```bash
+# Export VM with all data (from current directory with .clonebox.yaml)
+clonebox export . --user --include-data -o clonebox-vm.tar.gz
+
+# Or export specific VM by name
+clonebox export safetytwin-vm --include-data -o safetytwin.tar.gz
+
+# Extract to get the disk image
+tar -xzf clonebox-vm.tar.gz
+cd clonebox-clonebox
+ls -la  # Should show disk.qcow2, vm.xml, etc.
+```
+
+### Step 3: Convert to Proxmox Format
+
+```bash
+# Install qemu-utils if not installed
+sudo apt install qemu-utils
+
+# Convert qcow2 to raw format (Proxmox preferred)
+qemu-img convert -f qcow2 -O raw disk.qcow2 vm-disk.raw
+
+# Or convert to qcow2 with compression for smaller size
+qemu-img convert -f qcow2 -O qcow2 -c disk.qcow2 vm-disk-compressed.qcow2
+```
+
+### Step 4: Transfer to Proxmox Host
+
+```bash
+# Using scp (replace with your Proxmox host IP)
+scp vm-disk.raw root@proxmox:/var/lib/vz/template/iso/
+
+# Or using rsync for large files
+rsync -avh --progress vm-disk.raw root@proxmox:/var/lib/vz/template/iso/
+```
+
+### Step 5: Create VM in Proxmox
+
+1. **Log into Proxmox Web UI**
+
+2. **Create new VM:**
+   - Click "Create VM"
+   - Enter VM ID and Name
+   - Set OS: "Do not use any media"
+
+3. **Configure Hardware:**
+   - **Hard Disk:** 
+     - Delete default disk
+     - Click "Add" → "Hard Disk"
+     - Select your uploaded image file
+     - Set Disk size (can be larger than image)
+     - Set Bus: "VirtIO SCSI"
+     - Set Cache: "Write back" for better performance
+
+4. **CPU & Memory:**
+   - Set CPU cores (match original VM config)
+   - Set Memory (match original VM config)
+
+5. **Network:**
+   - Set Model: "VirtIO (paravirtualized)"
+
+6. **Confirm:** Click "Finish" to create VM
+
+### Step 6: Post-Import Configuration
+
+1. **Start the VM in Proxmox**
+
+2. **Update network configuration:**
+   ```bash
+   # In VM console, update network interfaces
+   sudo nano /etc/netplan/01-netcfg.yaml
+   
+   # Example for Proxmox bridge:
+   network:
+     version: 2
+     renderer: networkd
+     ethernets:
+       ens18:  # Proxmox typically uses ens18
+         dhcp4: true
+   ```
+
+3. **Apply network changes:**
+   ```bash
+   sudo netplan apply
+   ```
+
+4. **Update mount points (if needed):**
+   ```bash
+   # Mount points will fail in Proxmox, remove them
+   sudo nano /etc/fstab
+   # Comment out or remove 9p mount entries
+   
+   # Reboot to apply changes
+   sudo reboot
+   ```
+
+### Alternative: Direct Import to Proxmox Storage
+
+If you have Proxmox with shared storage:
+
+```bash
+# On Proxmox host
+# Create a temporary directory
+mkdir /tmp/import
+
+# Copy disk directly to Proxmox storage (example for local-lvm)
+scp vm-disk.raw root@proxmox:/tmp/import/
+
+# On Proxmox host, create VM using CLI
+qm create 9000 --name clonebox-vm --memory 4096 --cores 4 --net0 virtio,bridge=vmbr0
+
+# Import disk to VM
+qm importdisk 9000 /tmp/import/vm-disk.raw local-lvm
+
+# Attach disk to VM
+qm set 9000 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-9000-disk-0
+
+# Set boot disk
+qm set 9000 --boot c --bootdisk scsi0
+```
+
+### Troubleshooting
+
+- **VM won't boot:** Check if disk format is compatible (raw is safest)
+- **Network not working:** Update network configuration for Proxmox's NIC naming
+- **Performance issues:** Use VirtIO drivers and set cache to "Write back"
+- **Mount errors:** Remove 9p mount entries from /etc/fstab as they won't work in Proxmox
+
+### Notes
+
+- CloneBox's bind mounts (9p filesystem) are specific to libvirt/QEMU and won't work in Proxmox
+- Browser profiles and app data exported with `--include-data` will be available in the VM disk
+- For shared folders in Proxmox, use Proxmox's shared folders or network shares instead
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) file.

{clonebox-0.1.12 → clonebox-0.1.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clonebox"
-version = "0.1.12"
+version = "0.1.14"
 description = "Clone your workstation environment to an isolated VM with selective apps, paths and services"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{clonebox-0.1.12 → clonebox-0.1.14}/src/clonebox/__init__.py

@@ -5,7 +5,7 @@ Selectively clone applications, paths and services to a new virtual machine
 with bind mounts instead of full disk cloning.
 """
 
-__version__ = "0.1.12"
+__version__ = "0.1.13"
 __author__ = "CloneBox Team"
 
 from clonebox.cloner import SelectiveVMCloner