Set up Docker test environments for TestOps
Similar to Create a Local Test Environment with an Agent, you can create a Docker test environment with a compatible Agent in Katalon TestOps.
Set up an Agent
Requirements
Set up a Docker Agent
To set up a Docker Agent, follow these steps:- Sign in to Katalon TestOps and go to your project. Then navigate to .
This shows the
Test Environments page. It also lists the agents you have.
![Current Agents in Katalon TestOps.](/c75aab60-9ddf-11ee-b8c3-0242c7a41fd4/TO_Decemeber_20_2023_Test_Environments_page.png)
- Click on Create Local Test Environment.
- Alternatively you can click on Agent Setup to go to the same page.
This shows the
Agent Setup page.
![The Agent setup page in Katalon TestOps.](/a4c592e0-9de4-11ee-b8c3-0242c7a41fd4/TO_December_20_2023_Agent_Setup.png)
- Select the Docker Environment tab.
- In the Agent Name section, create a name for the Agent (e.g., my_docker_agent).
- In the Katalon API Key section, select default or create your own.
- In the Select method section, select the Docker Container to start with.
- Copy & paste the configuration labeled docker-compose.yml to your docker file.
- Use the next command labeled Bash to start the agent.
- After the agent successfully starts, assign your agent to a project. To learn how, see: Manage the Agent status.
Once the Docker container is live, you can check for the Agent status from the Test Environments page.
![The Docker Agent running.](/32bd9fb0-9977-11ee-b8c3-0242c7a41fd4/docker_desktop_agent_running.png)
![The Test Environments page in Katalon TestOps.](/c75aab60-9ddf-11ee-b8c3-0242c7a41fd4/TO_Decemeber_20_2023_Test_Environments_page.png)