Installation with Docker

How to use Docker to install Stoobly


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


Start the Docker container with the following command:

docker run -it \
    --net="host" \
    -v ~/.mitmproxy:/home/stoobly/.mitmproxy \
    -v ~/.stoobly:/home/stoobly/.stoobly \
    --name stoobly-agent \

The above command will:

  1. Download the Docker image from Docker Hub

  2. Start the proxy server 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:/root/.stoobly Docker option

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

UI server listening at

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

Last updated