Optimus Cloud helps you easily setup an in-house mobile device lab to manage your devices.

1. OPTIMUS CLOUD
Connecting DevicesTogether

2. PREREQUISITES
• Docker - https://www.docker.com/
• Appium - http://appium.io/
• Android SDK
• XCODE *

3. PROTIP
Install Optimus-CLI to setup machine for running appium tests
npm install -g optimus-cli
optimus doctor
optimus setup

4. TERMINOLOGIES

5. WORKERS
• Machines where devices/emulators/simulators are
connected/running
• MacMini
• Linux Box
• Windows Machine

6. CLOUD
• Machine or a cluster where Optimus Cloud
Services Run
• MacMini
• AWS
• GCP

7. CLIENT
• Dev Machine from where the tests are executed
• Laptop
• CI Runner

8. BIRDVIEW

9. Client Optimus Cloud Worker
Note: Client and Worker should be on same intranet

10. OPTIMUS CLOUD SETUP

11. STEP 1
DEPLOYING OPTIMUS CLOUD
SERVICES

12. MACMINI
• The machine where Optimus cloud get deployed should have docker
installed.
• Once the docker is installed run below curl in a folder of your choice.
• curl -OL https://raw.githubusercontent.com/testvagrant/OptimusCloud/master/docker-
compose.yml
• Launch the cloud using below command, on successful launch you will find
logs as shown in the image
• docker-compose up
• Keep a record of the ip address of the machine where cloud is deployed
• e.g. 192.168.1.12

14. STEP 2
DEPLOYING WORKER SERVICE
ON WORKERS

15. WORKERS
• Download worker service gem
• gem install optimus-runner
• Create OptimusCloud Env file.
• Create an file as OptimusCloud.env and enter the OptimusCloud host which was recorded in step 1.
Use the sample OptimusCloud.env file shared in OptimusCloud kit
• Launch OptimusWorker
• optimus-runner run -e OptimusCloud.env
• optimus-runner start -e OptimusCloud.env // If you want to run worker service in the background
• On Successful launch your worker service will detect the devices connected to the worker and launches
appium sessions as shown in the image.

16. REPLICATE STEP 2 FOR AS MANY
WORKERS ASYOU WANT

17. STEP 3
UPDATE CLIENT WITH OPTIMUS
CLOUD LANGUAGE BINDINGS

18. JAVA LANGUAGE BINDING
• Add JavaClient dependency to your project from
here
• https://search.maven.org/artifact/
com.testvagrant.optimuscloud/javaclient/1.0.1-beta/pom
• Refer to the sample project shared in the
OptimusCloud kit

19. STEP 4
TESTYOUR CLOUD BY
RUNNINGTESTS