Create your first OpenSearch UI application, connect a data source, and launch the interface.
Quick Start
Prerequisites
- An AWS account with IAM permissions for OpenSearch Service
- At least one OpenSearch domain or Serverless collection
- AWS CLI v2 installed (for CLI steps)
Step 1: Create an application
Using the Console
- Open the OpenSearch Service Console
- In the left nav, choose OpenSearch UI (Dashboards)
- Click Create application
- Enter a name (e.g.,
my-first-app) - Leave IAM authentication as default (for SSO, see Enterprise Admin)
- Click Create — status changes from
CREATINGtoACTIVEin 1–2 minutes
Using the AWS CLI
aws opensearch create-application \
--name my-first-app \
--region us-east-1Check status:
aws opensearch get-application \
--id app-abc123def456 \
--region us-east-1 \
--query 'status'Stuck in CREATING? Check the Troubleshooting guide — usually a missing iam:CreateServiceLinkedRole permission.
Step 2: Connect a data source
Using the Console
- Open your application detail page
- In Associated data sources, click Manage data sources
- Select your OpenSearch domains and/or Serverless collections
- Click Next → Save
Using the AWS CLI
aws opensearch update-application \
--id app-abc123def456 \
--region us-east-1 \
--data-sources '[
{
"dataSourceArn": "arn:aws:es:us-east-1:123456789012:domain/my-domain",
"dataSourceDescription": "Production logs domain"
}
]'VPC domains require extra authorization. See Connectivity Issues.
Step 3: Launch and explore
- Click Launch Application on the detail page
- You'll see the Welcome to OpenSearch page with workspace categories
- Click Create Workspace under your use case (e.g., Observability for log analysis)
What's next
- Configuration — IAM permissions and authentication setup
- Multi-Source Observability — connect multiple data sources