Skip to main content

Team Management

Create teams, invite members, and manage permissions in Hydranaut.

Overview​

Teams in Hydranaut:

  • Group users with shared responsibilities
  • Control access to services and environments
  • Define ownership of services
  • Support unlimited members across all tiers

Team Roles​

RolePermissions
AdminFull access, manage members, delete team
DeveloperAdd/edit services, view metrics, configure alerts
ViewerRead-only access to dashboards and metrics

Creating a Team​

Step 1: Navigate to Teams​

  1. Go to Teams → Create Team
  2. Click New Team button

Step 2: Configure Team Details​

Fill in team information:

  • Team Name: e.g., "Backend Team", "Frontend Team"
  • Description: Team's responsibilities
  • Default Environment: Primary environment this team works in
  • Notification Email: Team-wide alert email (optional)

Step 3: Set Environment Access​

Select which environments this team can access:

  • Production
  • Staging
  • Development

Note: Teams can only manage services in their assigned environments.

Step 4: Create Team​

Click Create Team to finalize.

Inviting Team Members​

Step 1: Access Team Settings​

  1. Select your team from Teams list
  2. Click Members tab
  3. Click Invite Member

Step 2: Send Invitation​

Fill in invitation details:

  • Email Address: Member's work email
  • Role: Select Admin, Developer, or Viewer
  • Personal Message: Optional welcome message

Click Send Invitation.

Step 3: Member Accepts​

The invited user will:

  1. Receive email invitation
  2. Click invitation link
  3. Create account (if new user) or log in
  4. Automatically join your team

Managing Team Members​

Changing Member Roles​

  1. Go to Teams → Select team → Members
  2. Find member in list
  3. Click role dropdown
  4. Select new role
  5. Click Update

Removing Team Members​

  1. Go to Teams → Select team → Members
  2. Find member in list
  3. Click Remove (trash icon)
  4. Confirm removal

Warning: Removed members lose access to all team services immediately.

Transferring Team Ownership​

  1. Go to Teams → Select team → Settings
  2. Click Transfer Ownership
  3. Select new owner from member list
  4. Confirm transfer

Note: Only current owner can transfer ownership.

Team Permissions​

What Admins Can Do​

  • Add/remove team members
  • Change member roles
  • Create/edit/delete services
  • Configure monitoring and alerts
  • Manage team settings
  • Delete team

What Developers Can Do​

  • Create/edit services
  • Configure service monitoring
  • Set up alerts
  • View all metrics and dashboards
  • Cannot manage team members

What Viewers Can Do​

  • View service dashboards
  • See health metrics
  • Read alert history
  • Cannot modify any settings

Managing Multiple Teams​

Team Limits by Tier​

TierMax Teams
Free1
Professional3
TeamsUnlimited

Organizing Teams​

By Function:

  • Backend Team
  • Frontend Team
  • Infrastructure Team
  • QA Team

By Product:

  • Product A Team
  • Product B Team
  • Platform Team

By Environment:

  • Production Team
  • Staging Team

Cross-Team Collaboration​

Services can only belong to one team, but:

  • Multiple teams can access the same environment
  • Teams can view (but not edit) other teams' services
  • Use shared environments for visibility

Team Settings​

Notification Preferences​

Configure team-wide alert settings:

  1. Go to Teams → Select team → Settings
  2. Navigate to Notifications
  3. Configure:
    • Email Alerts: Enable/disable team email
    • Slack Channel: Connect team Slack channel
    • Alert Frequency: Immediate, Hourly digest, Daily digest

Default Service Settings​

Set defaults for all services created by this team:

  1. Go to Teams → Select team → Settings → Defaults
  2. Configure:
    • Default Health Check Interval: 5 minutes
    • Default Alert Threshold: 2 failed checks
    • Default Timeout: 30 seconds

Best Practices​

Team Structure​

Small Organizations (< 10 people):

  • Single team with all members
  • Use roles to control permissions

Medium Organizations (10-50 people):

  • Teams by function (Backend, Frontend, DevOps)
  • Shared access to Production environment

Large Organizations (50+ people):

  • Teams by product or service domain
  • Environment-specific teams for Production

Role Assignment​

  • Admins: Team leads, senior engineers (limit to 2-3 per team)
  • Developers: Most team members
  • Viewers: Stakeholders, managers, support staff

Onboarding New Members​

  1. Send invitation with personal welcome message
  2. Assign Viewer role initially
  3. Provide team documentation and runbook
  4. Upgrade to Developer after onboarding complete
  5. Consider Admin role after 3-6 months

Troubleshooting​

Invitation Not Received​

Problem: Team member didn't receive invitation email.

Solutions:

  • Check spam/junk folder
  • Verify email address is correct
  • Resend invitation from Members tab
  • Check email deliverability in Account Settings

Can't Create New Team​

Problem: "Create Team" button disabled.

Solutions:

  • Check subscription tier limits (Free: 1 team, Professional: 3 teams)
  • Verify you have account Admin role
  • Upgrade subscription if at limit

Member Can't Access Service​

Problem: Team member can't see or edit a service.

Solutions:

  • Verify member's role (Viewer can't edit)
  • Check team has access to service's environment
  • Confirm service is owned by correct team
  • Verify member accepted invitation and logged in

Can't Remove Team Member​

Problem: Remove button is disabled.

Solutions:

  • Only Admins can remove members
  • Can't remove yourself (transfer ownership first)
  • Can't remove last Admin (promote another member first)

Advanced Team Management​

Service Ownership Transfer​

Move a service from one team to another:

  1. Go to Services → Select service
  2. Click Edit Service
  3. Change Owning Team dropdown
  4. Click Save

Note: New team must have access to service's environment.