> For the complete documentation index, see [llms.txt](https://alethio.gitbook.io/memento/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alethio.gitbook.io/memento/running-memento/via-docker-compose.md).

# Via docker-compose

The simplest way to run the whole setup is by using the included docker compose

## Video guide

For a video version of the step-by-step guide below click on the following image. Note that all the commands executed in the video are part of the **Step-by-step guide** below.&#x20;

[<img src="https://asciinema.org/a/5FdbyDtlPzaeukNFAmoFnje86.svg" alt="asciicast" data-size="original">](https://asciinema.org/a/5FdbyDtlPzaeukNFAmoFnje86)

## Step-by-step guide

### Prerequisites

* [docker-compose](https://docs.docker.com/compose/install/)
* wget

### Set up the environment

Start by creating a folder on your machine to host all the memento-related files. This can be placed anywhere.&#x20;

Just keep in mind that it requires some disk space as it will also host the volume for the database.

```bash
mkdir memento
cd memento
```

The next step is to download the config and  docker-compose file from github. You can do that manually or using the following commands:

```bash
wget -q --show-progress https://raw.githubusercontent.com/Alethio/memento/master/docker-compose.yml
wget -q --show-progress https://raw.githubusercontent.com/Alethio/memento/master/config-sample.yml
```

At the end of this step, your directory should look like follows:

```bash
~/memento ❯ tree
.
├── config-sample.yml
└── docker-compose.yml

0 directories, 2 files
```

Next step is to create a folder that our docker-compose will mount as a volume for the memento container. We'll use this to host Memento's configuration file.

```
mkdir -p .volumes/memento
```

### Copy the config and edit it as needed

By default, the values for postgres and redis are correct for using with docker compose.

```
mv config-sample.yml .volumes/memento/config.yml

# you can use any other text editor here
vim .volumes/memento/config.yml
```

### Start everything

```
docker-compose up -d
```

### Open the dashboard to check progress

```
http://localhost:3000
```
