Step 1: Download and Extract

1. Download will save as: pugworks-backup-agent-macos.tar.gz
2. Double-click to extract, or use Terminal: tar -xzf pugworks-backup-agent-macos.tar.gz📋

Step 2: Run the Agent

1. Move backup-agent.app to Applications folder (optional)
2. Double-click the app to run
3. If prompted about unverified developer, go to System Preferences > Security & Privacy > General and click "Open Anyway"
4. Click "Register" and enter your registration token

No additional software required! macOS includes WebKit by default. The agent is a native application with no dependencies.

Tip: Add the app to your Login Items (System Preferences > Users & Groups > Login Items) to start automatically when you log in.

Step 1: Install WebKitGTK (Required)

The agent requires WebKitGTK for the user interface. Install it using your package manager:

Step 2: Download and Extract

1. Download will save as: pugworks-backup-agent-linux.tar.gz
2. Open a terminal and navigate to your Downloads folder: cd ~/Downloads📋
3. Extract the archive: tar -xzf pugworks-backup-agent-linux.tar.gz📋

Step 3: Run the Agent

1. Make executable: chmod +x pugworks-backup-agent📋
2. Run the agent: ./pugworks-backup-agent📋
3. Click "Register" and enter your registration token

Optional: Install System-Wide

sudo mv pugworks-backup-agent /usr/local/bin/
pugworks-backup-agent

Tip: Logs are stored in ~/.config/pugworks/backup-agent/logs/. Use the built-in Logs tab to view them.

For IT Administrators: Deploy the backup agent across your organization using enterprise management tools like SCCM, Intune, PDQ Deploy, Ansible, or Group Policy.

Step 1: Obtain Your Registration Token

1. Contact your PugWorks account manager to obtain your organization's registration token
2. The token format is: PWBK-XXXX-XXXX-XXXX-XXXX
3. This token links all deployed agents to your company account

Step 2: Download the Agent Package

1. Download the appropriate package for your target systems
2. Host the package on your internal file share or deployment server
3. Verify the SHA256 checksum matches the value shown on your download page

Step 3: Silent Installation Commands

Use these commands in your deployment scripts for automated installation:

# Download and extract
Invoke-WebRequest -Uri "YOUR_DOWNLOAD_URL" -OutFile "pugworks-backup-agent-windows.zip"
Expand-Archive pugworks-backup-agent-windows.zip -DestinationPath "C:\Program Files\PugWorks Backup"

# Create scheduled task to run at login
$action = New-ScheduledTaskAction -Execute "C:\Program Files\PugWorks Backup\pugworks-backup-agent.exe"
$trigger = New-ScheduledTaskTrigger -AtLogon
Register-ScheduledTask -TaskName "PugWorks Backup Agent" -Action $action -Trigger $trigger -RunLevel Highest

# Install WebKitGTK dependency
sudo apt install -y libwebkit2gtk-4.0-37 || sudo apt install -y libwebkit2gtk-4.1-0

# Download and extract
wget "YOUR_DOWNLOAD_URL" -O pugworks-backup-agent-linux.tar.gz
tar -xzf pugworks-backup-agent-linux.tar.gz -C /opt/

# Install system-wide
sudo mv /opt/pugworks-backup-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/pugworks-backup-agent

# Create systemd service (optional)
sudo tee /etc/systemd/system/pugworks-backup.service > /dev/null << 'EOF'
[Unit]
Description=PugWorks Backup Agent
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/pugworks-backup-agent
Restart=on-failure
User=%i

[Install]
WantedBy=default.target
EOF

# Download and extract
curl -L "YOUR_DOWNLOAD_URL" -o pugworks-backup-agent-macos.tar.gz
tar -xzf pugworks-backup-agent-macos.tar.gz

# Move to Applications
mv "backup-agent.app" /Applications/

# Remove quarantine attribute
xattr -d com.apple.quarantine "/Applications/backup-agent.app"

Step 4: Verify Deployment

1. Run the agent on a test machine and verify registration
2. Check the Backup Portal dashboard under "Agents" to confirm the agent appears
3. Newly registered agents will appear within 5 minutes of successful deployment

Network Requirements:

Ensure the following URLs are accessible from deployed machines:

• api.datarunsclouds.com (Port 443) - API communication
• *.s3.amazonaws.com (Port 443) - Backup data storage
• cognito-idp.us-east-1.amazonaws.com (Port 443) - Authentication

Need Help? Contact your PugWorks account manager or email enterprise@pugworks.com for deployment assistance and custom configuration options.