Skip to main content

Getting Started with Tesmon

The Tesmon platform is divided into two main components: Tesmon Desktop for local use and Tesmon Cloud for automated testing.

Tesmon Desktop

Tesmon Desktop is designed for local development and testing. Here's how you can get started:

  • Download and Use Privately: Download Tesmon Desktop and start using it locally on your machine. It's private and doesn't require an account.
  • Access to Premium Features: Advanced features are available as premium offerings, for which you'll need to create an account.

Tesmon Cloud

Tesmon Cloud is your solution for automated testing across various environments:

  • Account Creation: To use Tesmon Cloud, sign up for an account.
  • Automation Testing Capabilities: Perfect for conducting automated tests in distributed systems, applicable for local machines, as well as 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.