Skip to main content

Getting Started

Tesmon Desktop

For local development and testing:

  • Download and Use Privately: Simply download Tesmon Desktop and start using it for your local development. It's completely private and doesn't require a user account.
  • Premium Features: Some advanced features are premium and will require you to create an account to access them.

Tesmon Cloud

For automated testing in various environments:

  • Account Requirement: Using Tesmon Cloud requires you to sign up for an account.
  • Automation Testing: Ideal for running automated tests for distributed systems, whether on your local machine or in pre-production and production environments.


  1. Create an account: Visit the Tesmon Web App to create your Tesmon account.

  2. Install the Tesmon CLI or VS Code extension: Choose your preferred method for interacting with Tesmon. You can either install the Tesmon Command Line Interface (CLI) tool on your local machine or use the Tesmon VS Code extension. The CLI provides command-line access, while the VS Code extension offers an integrated experience within your development environment.

  3. Create an environment: Create an environment in Tesmon that corresponds to the Test Run Engine, establishing a 1:1 mapping. This environment allows you to seamlessly connect with your local or cloud environments, such as dev, staging, or production. Refer to the Environments documentation for detailed instructions.

  4. Deploy the Test Run Engine: Deploy the Test Run Engine (TRE) to execute tests within your local or cloud infrastructure. The TRE is responsible for test execution and real-time monitoring. Refer to the deployment guide for instructions.

  5. Author and Run Tests: Author your tests using Tesmon's test authoring capabilities and run them locally to validate their behavior. Check out the Test creation guide for step-by-step instructions on Authoring tests, and the Running Tests section to learn how to execute your tests.

CI/CD and Version control

  1. Set up Git Integration: Configure the integration between Tesmon and your Git provider. This enables Tesmon to index Tesmon tests from your source code repository. Refer to the Git Integration setup guide for detailed instructions.

  2. Push Tests to your Git Provider: Once you have added your locally validated tests to the linked repository and pushed them to your Git provider, Tesmon will build and make them available for execution.

  3. Run Tests with Tesmon UI or CI/CD: Run your tests using Tesmon's Web App, schedule automated runs for regular testing, or seamlessly trigger them through your CI/CD pipeline. Explore the Running Tests section to learn more about the available approaches and how to effectively run, schedule, and analyze the test runs.

📄️ Workspaces

Tesmon workspaces provide a seamless way to organize and collaborate with your team, especially in scenarios where multiple teams are using Tesmon for their testing across different environments. By linking a workspace to a Git repository, you establish a logical separation that ensures each team can work independently and efficiently. This separation becomes essential when different teams are working on their own sets of tests or targeting different environments within the Tesmon platform. Any updates or pushes made to the linked Git repository will be automatically built within the corresponding workspace, ensuring a smooth and streamlined collaboration experience across teams and environments.