Installation Guide

Installation Guide

This comprehensive guide walks you through the complete setup process for Global Watch, including workspace configuration, team setup, and integrations.

Prerequisites

Before you begin, ensure you have:

• A valid email address
• Modern web browser (Chrome 90+, Firefox 88+, Safari 14+, or Edge 90+)
• Stable internet connection
• (Optional) Organization details for team account setup

Account Setup

Creating a Personal Account

1. Visit https://app.global.watch/sign-up
2. Choose your sign-up method:
   • Email/Password - Enter your email and create a secure password
   • Google OAuth - Sign in with your Google account
3. Complete email verification if using email/password
4. You'll be redirected to the onboarding flow

Creating a Team Account

Team accounts provide shared workspaces for organizations:

1. After creating your personal account, navigate to Settings → Teams
2. Click Create Team
3. Enter your team details:
   • Team Name - Your organization name
   • Team Slug - URL-friendly identifier (e.g., acme-corp)
4. Click Create

Workspace Configuration

Profile Settings

Configure your personal profile:

1. Navigate to Settings → Profile
2. Update your information:
   • Display name
   • Profile picture
   • Contact information
3. Click Save Changes

Notification Preferences

Customize how you receive notifications:

1. Go to Settings → Notifications
2. Configure notification channels:
   • Email - Receive updates via email
   • In-App - See notifications in the platform
   • Push - Browser push notifications (if enabled)
3. Select notification types:
   • Project updates
   • Member activity
   • Billing alerts
   • System announcements

Language & Region

Set your preferred language and regional settings:

1. Navigate to Settings → Preferences
2. Select your language:
   • English (en)
   • Portuguese (pt-BR)
3. Set your timezone
4. Choose date/time format preferences

Team Configuration

Member Roles

Global Watch uses a role-based access control system:

Inviting Team Members

1. Navigate to your team workspace
2. Go to Settings → Members
3. Click Invite Member
4. Fill in the invitation form:

   Email: colleague@company.com
   Role: Member
   Message: (optional welcome message)

5. Click Send Invitation

Managing Permissions

Fine-tune member permissions:

1. Go to Settings → Members
2. Click on a member's name
3. Adjust their role or specific permissions
4. Click Save

Project Setup

Creating a Project

1. From your dashboard, click New Project
2. Enter project details:
   • Name - Descriptive project name
   • Description - Project overview and goals
   • Tags - Categorization labels
3. Click Create Project

Configuring Project Settings

After creating a project:

1. Open the project
2. Navigate to Settings
3. Configure:
   • General - Name, description, status
   • Members - Project-specific access
   • Integrations - External service connections
   • Notifications - Project alert settings

Defining Project Boundaries

Set up geospatial boundaries for your project:

1. Open your project
2. Go to the Map tab
3. Use the toolbar to:
   • Draw Polygon - Outline forest boundaries
   • Import GeoJSON - Upload existing boundary data
   • Edit Vertices - Fine-tune boundary points
4. Save your changes

// Example GeoJSON import format
{
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [-60.0, -3.0],
        [-60.0, -3.5],
        [-59.5, -3.5],
        [-59.5, -3.0],
        [-60.0, -3.0]
      ]
    ]
  },
  "properties": {
    "name": "Forest Block A"
  }
}

Billing Setup

Subscription Plans

Global Watch offers flexible pricing:

Setting Up Billing

1. Navigate to Settings → Billing
2. Click Upgrade Plan or Manage Subscription
3. Select your desired plan
4. Enter payment information
5. Confirm your subscription

Usage Tracking

Monitor your usage:

1. Go to Settings → Billing → Usage
2. View metrics:
   • Total hectares managed
   • Active team members
   • API calls (if applicable)

Integrations

Available Integrations

Global Watch integrates with various services:

• Mapbox - Enhanced mapping capabilities
• Stripe - Payment processing
• Email Services - Notification delivery

Configuring Integrations

1. Navigate to Settings → Integrations
2. Select the integration you want to configure
3. Follow the setup wizard
4. Test the connection
5. Enable the integration

Security Configuration

Two-Factor Authentication (2FA)

Enable 2FA for enhanced security:

1. Go to Settings → Security
2. Click Enable 2FA
3. Scan the QR code with your authenticator app
4. Enter the verification code
5. Save your backup codes securely

Session Management

Manage your active sessions:

1. Navigate to Settings → Security → Sessions
2. View all active sessions
3. Revoke sessions you don't recognize

Verification Checklist

Before you start using Global Watch, verify:

• Email address verified
• Profile information complete
• Team created (if applicable)
• Team members invited
• First project created
• Project boundaries defined
• Billing configured (for paid features)
• 2FA enabled (recommended)

Troubleshooting

Common Setup Issues

Team slug is already taken

Team slugs must be unique across Global Watch. Try adding your company location or a number (e.g., acme-corp-br or acme-corp-2024).

Invitation email not received

Ask the invitee to check their spam folder. Ensure the email address is correct. You can resend the invitation from the Members page.

GeoJSON import fails

Verify your GeoJSON is valid using a tool like geojson.io. Ensure coordinates are in the correct format (longitude, latitude).

Payment method declined

Verify your card details are correct. Contact your bank if the issue persists. You can also try a different payment method.

Next Steps

Now that your workspace is configured:

1. Create your first project
2. Explore features - Learn about all platform capabilities
3. API integration - Connect external systems
4. Compliance setup - Configure audit and compliance features

Support Resources

• Documentation - You're here! Browse all guides
• Email Support - support@global.watch
• Community Forum - Connect with other users
• Status Page - Check system status at status.global.watch