NetLog Viewer Docker Container

September 6, 2024 ยท View on GitHub

This repository contains a Docker image for serving the NetLog Viewer webapp locally. The NetLog Viewer allows you to load and analyze NetLog dumps exported from Chromium Basesd browsers (Google Chrome, Microsoft Edge)

Table of Contents

Getting Started

These instructions will help you set up and run the NetLog Viewer webapp using Docker.

Prerequisites

  • Docker installed on your machine. You can download Docker from here.

Pull the Docker Image

You can pull the latest image with docker pull ghcr.io/martadams89/netlog-viewer:latest

Building the Docker Image

Instead of pulling the image, you can build it yourself

  1. Clone this repository:

    git clone https://github.com/martinadamsUL/netlog-viewer.git
cd netlog-viewer

  2. Build the Docker image:

    docker build -t netlogviewer .

Running the Docker Container

Run the Docker container using the following command:

docker run -d -p 8080:8080 netlogviewer

This will start the container in detached mode and map port 8080 of the container to port 8080 on your host machine.

Running in Docker compose

You can also bring up the container using docker-compose.

---
services:
  netlogviewer:
    image: ghcr.io/martinadamsUL/netlogviewer:latest
    container_name: rnetlogviewer
    ports:
      - 8080:8080
    restart: unless-stopped

Accessing the Webapp

Open your web browser and navigate to:

http://localhost:8080/

You should see the NetLog Viewer webapp interface.

Usage

  1. Export a NetLog dump from Chrome by navigating to chrome://net-export.
  2. Click on "Choose File" in the webapp interface and select your exported NetLog dump file.
  3. Analyze your NetLog data using the available tabs (Import, Events, Proxy, Timeline, DNS, Sockets, Cache).

Contributing

Contributions are welcome! Please open an issue or submit a pull request with your changes.

Steps to Contribute

  1. Fork the repository
  2. Create a new branch (git checkout -b feature-branch)
  3. Make your changes
  4. Commit your changes (git commit -am 'Add new feature')
  5. Push to the branch (git push origin feature-branch)
  6. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.