nstbrowser/browserless repository overview

Nstbrowser/browserless is an advanced enterprise browserless product. The Docker API⁠ is consistent with the Nstbrowser client⁠ in version130-202412251400.v1and above, versions below130-202412251400.v1are independent.

⁠Description

This Docker image provides a robust and scalable environment for running headless browser applications. Built on the existing Nstbrowser fingerprint library, it offers a Linux environment that allows you to efficiently automate and streamline browser-based tasks.

⁠Features:

• Pre-installed with the nstchrome core environment.
• Accepts parameters via environment variables to start the container.
• Ensures safe and isolated execution of browser automation tasks.
• Supports custom fingerprint parameters to launch browser instances.
• Fully supports popular Chrome DevTools Protocol (CDP) libraries.

⁠Why Use This Image?

Our browserless Docker image simplifies the deployment and scaling of browser automation tasks. It's perfect for developers and teams needing reliable and efficient browser automation in their CI/CD pipelines or standalone applications.

⁠Getting Started

To get started with running a container using this image, follow these steps:

⁠Pull the Image

The latest version of the image recommended

docker pull docker.io/nstbrowser/browserless:latest

⁠Run a Container

You must specify your TOKEN(API Key) and you can get one from Nstbrowser API Key⁠

docker run -it -e TOKEN=xxx -e PORT=8848 -p 8848:8848 --name nstbrowserless nstbrowser/browserless:latest

⁠Container Configuration

The Nstbrowserless docker container is highly-configurable and accepts parameters through environment variables when starting docker container. You can set parameters such as nstbrowserless server port, token, user data directory. Below is a description of each parameter.

• TOKEN

Nstbrowserless is designed to always require a token. This means you must pass a TOKEN env variable.

docker run -it -e TOKEN=xxx -p 8848:8848 --name nstbrowserless nstbrowser/browserless:latest

• PORT

By default, the Nstbrowserless server listens on port 8848. You can configure this in docker by pass a SERVER_PORT env variable.

docker run -it -e TOKEN=xxx -e SERVER_PORT=8000 -p 8000:8000 --name nstbrowserless nstbrowser/browserless:latest

• DATADIR

Sets a default directory to saving your browser data to.

docker run -it -e TOKEN=xxx -e DATADIR=/tmp/nstbrowserless/profiles -p 8848:8848 --name nstbrowserless nstbrowser/browserless:latest

For more information, refer to Nstbrowser API Docs⁠.

⁠License

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained). As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.