Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bugster.dev/llms.txt

Use this file to discover all available pages before exploring further.

Bugster authenticates to your app like a real user to run tests. Besides username/password, Bugster supports OTP (One-Time Password)—temporary codes sent via email during login.
Bugster provides a managed email address with access to incoming OTPs. You create an account in your app using this email.

​
Setup

1

Get your Bugster OTP email

Contact Bugster support or check your dashboard to obtain your dedicated OTP email address.
2

Create an account in your app

Register a new user in your application using the Bugster OTP email.
3

Add OTP credential to config.yaml

credentials:
  - id: otp-user
    email: ${BUGSTER_OTP_EMAIL}
    auth_type: otp
4

Set the environment variable

# .bugster/.env
BUGSTER_OTP_EMAIL=your.bugster.email@...
5

(Optional) Add to CI/CD

If using CI/CD, go to Projects → Settings → Environment Variables and add:
BUGSTER_OTP_EMAIL=your.bugster.email@...

​
Use OTP in tests

Add these fields to any test requiring OTP authentication: 
name: Dashboard access
page: /dashboard
credential_id: otp-user
requires_login: true
task: Verify dashboard loads after OTP login
steps:
  - Navigate to dashboard
  - Verify content is displayed
expected_result: Dashboard renders successfully
All tests with the same credential_id and requires_login: true share one authenticated session. Bugster logs in once, then reuses the session for subsequent tests. See Session Persistence for details.

​
Next steps

Credentials & roles

Configure username/password authentication

Session persistence

Share login sessions across tests