Skip to content

Docker run requires AWS mount for profile detection (UX improvement) #5

@MaheshShukla1

Description

@MaheshShukla1

Problem

When running IAM X-Ray via Docker without mounting ~/.aws, the app fails to detect AWS profiles.

While this is technically expected behavior, the error message is confusing for new users.

Current Behavior

  • Docker container runs successfully
  • AWS Profile mode shows "profile not found"
  • User does not clearly understand that a volume mount is required

Expected Behavior

  • Clear and friendly error message
  • Actionable instructions (mount ~/.aws or use env keys or Demo mode)
  • Link to README section

Impact

High confusion for first-time users trying AWS Profile mode.

Proposed Fix

  • Improve error messaging in session creation
  • Improve README Docker examples
  • Add UI hint when no profiles are detected

Environment

  • Version: v0.1.0-beta
  • OS: Windows / Mac / Linux
  • Docker: yes

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions