Run with Docker

How to use run Stoobly with Docker

Prerequisite

Docker must be installed. Refer to the official Docker install instructions here.

Running the Agent

Start the Docker container with the following command:

Linux

docker run \
    -p 8080:8080 \
    -p 4200:4200 \
    -v ~/.mitmproxy:/home/stoobly/.mitmproxy \
    -v ~/.stoobly:/home/stoobly/.stoobly \
    stoobly/agent

macOS

docker run -it \
    -p 8080:8080 \
    -p 4200:4200 \
    -v ~/.mitmproxy:/home/stoobly/.mitmproxy \
    -v ~/.stoobly:/home/stoobly/.stoobly \
    stoobly/agent

The above command will:

1. Download the stoobly/agent Docker image from Docker Hub

2. Start the proxy and UI server

3. Expose the proxy on port 8080 and the UI on port 4200

• If the proxy port conflicts, configure it with the --proxy-port INTEGER option

• If the UI port conflicts, configure it with --ui-port INTEGER option

The command will also mount the ~/.stoobly data directory from your host as a data volume to persist changes. If you don't want to persist changes then remove the -v ~/.stoobly:/home/stoobly/.stoobly Docker option

After running the command, you should see output similar to this to indicate that the agent started up successfully:

UI server listening at http://0.0.0.0:4200

Loading script /usr/local/lib/python3.10/site-packages/stoobly_agent/record.py
Proxy server listening at http://*:8080