Skip to content

Commit

Permalink
Merge branch 'main' into dev
Browse files Browse the repository at this point in the history
  • Loading branch information
GJFR committed Jul 3, 2024
2 parents c992a46 + 2e4ed10 commit 53d658b
Showing 1 changed file with 27 additions and 24 deletions.
51 changes: 27 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,35 +28,36 @@ This framework has been developed as part of the _"A Bug's Life: Analyzing the L
BugHog is compatible with UNIX systems running Docker, including WSL on Windows.
Follow these steps to get started:

1. **Clone this repository:**
### 1. Clone this repository:

```bash
git clone https://github.com/DistriNet/BugHog
cd BugHog
```

2. **Obtain images:**
```bash
git clone https://github.com/DistriNet/BugHog
cd BugHog
```

You will need at least 5 GB of disk space.
There are two options available to obtain the BugHog images, and you can switch between them by executing the appropriate command.
### 2. Obtain images:

***Option A:** Pulling (fastest)*
You will need at least 5 GB of disk space.
There are two options available to obtain the BugHog images, and you can switch between them by executing the appropriate command.

Use the following command to pull the necessary Docker images:
```bash
docker compose pull core worker nginx
```
#### Option A: Pulling (fastest)

> :bulb: If you prefer to use a version other than the latest, simply modify the `BUGHOG_VERSION` and / or `BUGHOG_WEB_VERSION` variables accordingly.
Use the following command to pull the necessary Docker images:
```bash
docker compose pull core worker nginx
```

***Option B:** Building*
> [!NOTE]
> If you prefer to use a version other than the latest, simply modify the `BUGHOG_VERSION` and / or `BUGHOG_WEB_VERSION` variables accordingly.
Use the following commands to build the Docker images yourself, for instance after you made changes to the source code:
```bash
docker compose build core worker nginx
```
#### Option B: Building

> :bulb: For reference, building takes about 4 minutes on a machine with 8 CPU cores and 8 GB of RAM.
Use the following commands to build the Docker images yourself, for instance after you made changes to the source code:
```bash
docker compose build core worker nginx
```
> [!NOTE]
> For reference, building takes about 4 minutes on a machine with 8 CPU cores and 8 GB of RAM.

## Usage
Expand All @@ -66,7 +67,8 @@ Launch BugHog using the following command:
docker compose up -d core nginx
```

> :warning: If you use `sudo` with this command, the `PWD` environment variable won't be passed to the BugHog containers, which is necessary for dynamically starting worker containers.
> [!WARNING]
> If you use `sudo` with this command, the `PWD` environment variable won't be passed to the BugHog containers, which is necessary for dynamically starting worker containers.
> To avoid this, explicitly pass on this variable: `sudo PWD=$PWD docker compose -d up ...`.
Open your web browser and navigate to [http://localhost:5000](http://localhost) to access the graphical interface.
Expand All @@ -77,7 +79,8 @@ BugHog can be stopped through:
docker compose down
```

> :warning: BugHog's own MongoDB instance will persist data within the [database](database) folder.
> [!WARNING]
> BugHog's own MongoDB instance will persist data within the [database](database) folder.
> Be sure to back-up accordingly, or use your own MongoDB instance as explained below.

Expand All @@ -93,7 +96,7 @@ If you prefer storing data in your own MongoDB instance, follow these steps:

### Adding your new experiments

Instructions to add your own custom experiments to the server can be found [here](https://github.com/DistriNet/BugHog-web/blob/main/experiments/README.md).
Instructions to add your own custom experiments to the server can be found [here](/experiments/README.md).
Be sure to restart the BugHog framework when you add a new experiment.

## Development
Expand Down

0 comments on commit 53d658b

Please sign in to comment.