# Install on Docker Desktop

## Installation Steps

### Setup Docker Desktop

First download, install, and run [Docker Desktop](https://www.docker.com/products/docker-desktop/).

### Get a GRAX Trial Key

Next, sign into the [GRAX Platform](https://platform.grax.com) and get a registration key.

Go to "Backends," then "New," then "GRAX for Docker Desktop," then "Create Key." You can then see a "Registration Key" in your list of backends. This key can only be activated once.

### Download and Configure GRAX Docker Compose Files

Download [GRAX Docker Compose Files](https://s3.amazonaws.com/grax-public-templates/master/docker/docker.zip), unzip them, and configure it with your registration key.

```bash
export GRAX_REGISTRATION_KEY=<Paste from GRAX Platform>
```

```bash
curl -L -o docker.zip https://s3.amazonaws.com/grax-public-templates/master/docker/docker.zip
unzip docker.zip
cd docker
echo "GRAX_REGISTRATION_KEY=$GRAX_REGISTRATION_KEY" >> .env
```

### Start Up GRAX with Docker Compose

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

After 30 seconds, GRAX is running alongside a database and storage service. You can go to the "Backend URL" from [GRAX Platform](https://platform.grax.com), e.g:

* <https://comfortable-trade-78.secure.grax.io>

You can pause GRAX with:

```bash
docker-compose stop
```

And resume again with `docker-compose up -d`.

## Resetting Everything

{% hint style="warning" %}
The following deletes all data in the object storage and database and releases the URL you used to access GRAX on your laptop. This can not be undone.
{% endhint %}

You can destroy all Docker resources with:

```bash
docker-compose down
docker rm -f $(docker ps -a -q) || true
docker image rm -f docker-grax || true
docker volume rm $(docker volume ls -q) || true
```

Then, sign into the [GRAX Platform](https://platform.grax.com), go to "Backends," and "Delete" your previously activated backend and registration key.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.grax.com/infrastructure/install-guides/install-on-docker-desktop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.