A web browser 🌎 hosted as a service, to render your JavaScript web pages as HTML
Uses serverful to expose puppeteer headless browser through a REST API.
Features
- Launch
🚀 inside a Docker container🐳 so you don't need to manage the dependencies🙌 ✅ - Deploy on AWS using an Antifragile Infrastructure that allows you to easily monitor activity and scale
📈 capacity✅
How to use
Use it in your terminal
Using it in your terminal requires Docker installed in your system.
Run the Docker image in a container
Detach from the container and expose port 9453.
docker run -d -p "9453:3000" hfreire/browser-as-a-service
Browse Google's website (https://www.google.com)
Use curl to fetch Google's website
curl 'http://localhost:9453/open?url=https%3A%2F%2Fwww.google.com'
Available REST API endpoints
Swagger documentation available at http://localhost:9453/docs.
Available usage environment variables
| Variable | Description | Required | Default value |
|---|---|---|---|
| PORT | The port to be used by the HTTP server. | false | 3000 |
| API_KEYS | The secret keys that should be used when securing endpoints. | false | undefined |
| SO_TIMEOUT | TCP socket connection timeout. | false | 120000 |
| BASE_PATH | Base path to be prefixed to all available endpoint paths. | false | / |
| PING_PATH | Endpoint path for pinging app. | false | /ping |
| HEALTHCHECK_PATH | Endpoint for checking app health. | false | /healthcheck |
| LOG_LEVEL | The log level verbosity. | false | info |
| ENVIRONMENT | The environment the app is running on. | false | undefined |
| ROLLBAR_API_KEY | The server API key used to talk with Rollbar. | false | undefined |
How to build
Clone the GitHub repo
git clone https://github.com/hfreire/browser-as-a-service.git
Change current directory
cd browser-as-a-service
Run the NPM script that will build the Docker image
npm run build
How to deploy
Deploy it from your terminal
Deploying it from your terminal requires terraform installed on your system and an antifragile infrastructure setup available in your AWS account.
Clone the GitHub repo
git clone https://github.com/hfreire/browser-as-a-service.git
Change current directory
cd browser-as-a-service
Run the NPM script that will deploy all functions
npm run deploy
Available deployment environment variables
| Variable | Description | Required | Default value |
|---|---|---|---|
| VERSION | The version of the app. | false | latest |
| ANTIFRAGILE_STATE_AWS_REGION | The AWS region used for the antifragile state . | false | undefined |
| ANTIFRAGILE_STATE_AWS_S3_BUCKET | The AWS S3 bucket used for the antifragile state. | false | undefined |
| ANTIFRAGILE_STATE_AWS_DYNAMODB_TABLE | The AWS DynamoDB table used for the antifragile state. | false | undefined |
| ANTIFRAGILE_INFRASTRUCTURE_DOMAIN_NAME | The domain used for the antifragile infrastructure. | true | undefined |
How to contribute
You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.
All donation proceedings will go to the Sverige för UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.
License
Read the license for permissions and limitations.