https://github.com/fernandocelmer/docker-selenium-lambda
Docker Selenium Lambda
https://github.com/fernandocelmer/docker-selenium-lambda
aws-lambda chromium docker firefox lambda selenium selenium-python tor
Last synced: 2 months ago
JSON representation
Docker Selenium Lambda
- Host: GitHub
- URL: https://github.com/fernandocelmer/docker-selenium-lambda
- Owner: FernandoCelmer
- License: gpl-3.0
- Created: 2025-11-29T08:51:19.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-11-30T03:12:20.000Z (7 months ago)
- Last Synced: 2025-12-01T10:59:26.976Z (7 months ago)
- Topics: aws-lambda, chromium, docker, firefox, lambda, selenium, selenium-python, tor
- Language: Python
- Homepage:
- Size: 44.9 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Selenium Lambda
[](https://github.com/FernandoCelmer/docker-selenium-lambda/actions/workflows/docker-lint.yml)
[](https://www.python.org/)
[](https://www.docker.com/)
[](https://hub.docker.com/r/fernandocelmer/docker-selenium-lambda)
[](https://aws.amazon.com/lambda/)
[](LICENSE)
A production-ready Docker image for AWS Lambda with Python 3.14, featuring Selenium web automation with support for Chromium, Firefox, and Tor Browser. Optimized for headless browser automation in serverless environments.
This image provides everything you need to run Selenium-based web scraping, testing, or automation tasks in AWS Lambda with support for multiple browsers. Each browser is available as a separate tag for optimized image sizes.
## Features
- **Python 3.14** - Latest Python version with build argument support
- **Selenium >=4.38.0** - Web automation framework
- **Chromium** - Headless browser (version 131.0.6778.85) with ChromeDriver
- **Firefox** - Headless browser with GeckoDriver
- **Tor Browser** - Privacy-focused browser with Tor network support
- **Multiple Browser Support** - Separate Docker tags for Chromium, Firefox, and Tor
- **Code Quality** - Hadolint for Dockerfile linting
- **CI/CD** - Automated build and push for all browsers
## Commands
### Chromium
```bash
make lint
make build-chromium
make test-chromium
make run-chromium
make push-chromium DOCKER_HUB_USER=yourusername
```
### Firefox
```bash
make lint
make build-firefox
make test-firefox
make run-firefox
make push-firefox DOCKER_HUB_USER=yourusername
```
### Tor Browser
```bash
make lint
make build-tor
make test-tor
make run-tor
make push-tor DOCKER_HUB_USER=yourusername
```
### Generic (defaults to Chromium)
```bash
make build BROWSER=chromium
make build BROWSER=firefox
make build BROWSER=tor
make test BROWSER=chromium
make run BROWSER=chromium
```
## Docker Hub
Pre-built images are available on Docker Hub: [fernandocelmer/docker-selenium-lambda](https://hub.docker.com/r/fernandocelmer/docker-selenium-lambda)
### Quick Start
**Chromium (default):**
```bash
docker pull fernandocelmer/docker-selenium-lambda:latest
docker run -p 9000:8080 -e BROWSER=chromium fernandocelmer/docker-selenium-lambda:latest
```
**Firefox:**
```bash
docker pull fernandocelmer/docker-selenium-lambda:firefox
docker run -p 9000:8080 -e BROWSER=firefox fernandocelmer/docker-selenium-lambda:firefox
```
**Tor Browser:**
```bash
docker pull fernandocelmer/docker-selenium-lambda:tor
docker run -p 9000:8080 -e BROWSER=tor fernandocelmer/docker-selenium-lambda:tor
```
### Available Tags
**Chromium:**
```bash
docker pull fernandocelmer/docker-selenium-lambda:latest
docker pull fernandocelmer/docker-selenium-lambda:chromium
```
**Firefox:**
```bash
docker pull fernandocelmer/docker-selenium-lambda:firefox
```
**Tor Browser:**
```bash
docker pull fernandocelmer/docker-selenium-lambda:tor
```
**Tag Descriptions:**
- `latest` - Chromium browser (default tag)
- `chromium` - Chromium browser
- `firefox` - Firefox browser
- `tor` - Tor Browser with Tor network support
## Build
**Chromium:**
```bash
docker build --build-arg BROWSER=chromium -t docker-selenium-lambda:chromium .
```
**Firefox:**
```bash
docker build --build-arg BROWSER=firefox -t docker-selenium-lambda:firefox .
```
**Tor Browser:**
```bash
docker build --build-arg BROWSER=tor -t docker-selenium-lambda:tor .
```
**Using Makefile:**
```bash
make build-chromium
make build-firefox
make build-tor
make build BROWSER=chromium
make build BROWSER=firefox
make build BROWSER=tor
```
## Test Lambda Function
```bash
curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" \
-H "Content-Type: application/json" \
-d '{}'
```
## Selenium Configuration
The Dockerfile includes:
- **Chromium**: Chrome for Testing (v131.0.6778.85) with ChromeDriver
- **Firefox**: Latest Firefox with GeckoDriver (v0.34.0)
- **Tor Browser**: Tor Browser (v13.0.16) with GeckoDriver and Tor network support
- All required system dependencies for headless browser operation
- Selenium Python package (>=4.38.0)
The Lambda function automatically detects the browser via `BROWSER` environment variable:
- Set `BROWSER=chromium` for Chromium
- Set `BROWSER=firefox` for Firefox
- Set `BROWSER=tor` for Tor Browser
**Chromium options optimized for AWS Lambda:**
- `--headless=new` - Run without GUI
- `--no-sandbox` - Required for Lambda environment
- `--disable-dev-shm-usage` - Prevents shared memory issues
- `--single-process` - Run in single process mode
**Firefox options optimized for AWS Lambda:**
- `--headless` - Run without GUI
- Optimized window size and memory settings
**Tor Browser options optimized for AWS Lambda:**
- `--headless` - Run without GUI
- SOCKS5 proxy configured to 127.0.0.1:9050
- Tor network routing enabled
- Optimized window size and memory settings
## Code Quality
The project uses Hadolint for Dockerfile linting. Configuration is in `.code_quality/.hadolint.yaml`.
GitHub Actions automatically runs linting on push and pull requests.
## Resources
- [Hadolint Documentation](https://hadolint.github.io/hadolint/)
- [AWS Lambda Python Image](https://docs.aws.amazon.com/lambda/latest/dg/python-image.html)
- [Selenium Documentation](https://www.selenium.dev/documentation/)
- [ChromeDriver for Testing](https://googlechromelabs.github.io/chrome-for-testing/)