Quick Start

Running the application

The easiest way to use WWWHerd is to run the premade container All-In-One container. The latest will always be the most recent tested version. You will need to be running the docker engine (you could probably use any CRE, but we tested with docker). The one that comes with Docker Desktop works just fine.

Pull the latest wwwherd image: docker pull wwwherd/all:latest

And run it: docker run -p80:80 -p8888:8888 -d wwwherd/all:latest

That's it. Point your web browser at your docker host, and you'll see the WWWHerd login. If you are running docker on your laptop or PC, that would be http://localhost/ Additionally, you can check out the test app used for the demonstrations and testing at http://localhost:8888/.

There is one account. Username: admin Password: aaaaaaaa (eight letter As). You can change the password and add other users in the UI.

IMPORTANT !!!!! IMPORTANT !!!!!!!!! IMPORTANT

* The container is completely ephemeral. Once you remove the container, all of your data in wwwherd will be gone. You can export much of your setup in the Admin tab, but it will not keep your run history and other stuff. *

Running the demo

Now that you have the application running, you can start the demo. The demo is a simple application that is used to demonstrate some of the capabilities of WWWHerd.

1) Download the demo database.

Download the database file

The file will be named wwwherd_demo.json and should be in your Downloads directory (unless you tell it to download elsewhere).

2) Import the database

Login
Go to the Admin screen
Import the downloaded database

IMPORTANT!!! In this video, the docker container host is on another machine. If it is on your laptop or pc, use 'localhost' as the address instead of 192.168.1.41.

3) Set up provider

The best provider we have encountered is Anthropic Claude Sonnet 4.6, but for 99% of the cases, Anthropic Claude Haiku 4.5 works great and is cheaper. That is not to say it will always be the best or that it is the only choice, but it is what we will show here.
See the providers documentation for more information.

Get your API key (in this demo it will be in the clipboard and ready to paste.)
Go to the Admin screen.
Add the provider

3) Start a demo run

Remember, in the demo we use '192.168.1.41' as the address, but if your docker host is on your laptop or pc, you should probably use 'localhost'

Create our first design. A design is like a template for a run that can be run more than once.
Select our design and click Start Run.
Put the target website address in the Host field. This is the test app running on port 8888 in our container.
Click submit.

4) Explore....

With your run underway, explore around some...

The following video is an example, though note it may take your run a little bit to finish. In the video the run is done.

5) More examples.

For a larger example of how to use WWWHerd, you can look at the Basic Acceptance Test (BAT). The BAT is executed before every release (among other tests). You can use the same instructions as above, but just a different database file. The BAT has a lot of good examples of how to use WWWHerd.

Download the BAT database file