Skip to content

🐳 Docker Start Guide

Docker setup instructions for SeleniumBase

1. Install the Docker Toolbox

You can get that from here:

You might also want to install the Docker Engine:

2. Create your SeleniumBase Docker environment

docker-machine create --driver virtualbox seleniumbase
(If your Docker environment ever goes down for any reason, you can bring it back up with a restart.)
docker-machine restart seleniumbase

3. Configure your shell

eval "$(docker-machine env seleniumbase)"

4. Go to the SeleniumBase home directory on the command line, which is where Dockerfile is located. (This assumes you've already cloned the SeleniumBase repo.)

5. Create your Docker image from your Dockerfile: (Get ready to wait awhile)

docker build -t seleniumbase .

If running on an Apple M1 Mac, use this instead:

docker build --platform linux/amd64 -t seleniumbase .

6. Run the example test with Chrome inside your Docker: (Once the test completes after a few seconds, you'll automatically exit the Docker shell)

docker run seleniumbase ./

7. Now run the same test with Firefox inside your Docker

docker run seleniumbase ./

8. You can also enter Docker and stay inside the shell

docker run -i -t seleniumbase

9. Now you can run the example test from inside the Docker shell


10. When you're satisfied, you may exit the Docker shell


11. (Optional) Since Docker images and containers take up a lot of space, you may want to clean up your machine from time to time when they’re not being used

Details on that can be found here:

Here are a few of those cleanup commands:

docker container prune
docker system prune
docker images | grep "<none>" | awk '{print $3}' | xargs docker rmi
docker rm 'docker ps --no-trunc -aq'

If you want to completely remove all of your Docker containers and images, use these commands: (If there's nothing to delete, those commands will return an error.)

docker rm -f $(docker ps -a -q)
docker rmi -f $(docker images -q)

Finally, if you want to wipe out your SeleniumBase Docker virtualbox, use these commands:

docker-machine kill seleniumbase
docker-machine rm seleniumbase

For more cleanup commands, check out:

13. (Optional) More reading on Docker can be found here