LogoLogo
TrustAPI Docs
  • Application
  • Support
  • Platform
  • Infrastructure
  • Security
  • Notices
  • Install Guides
    • Install on Heroku
    • Install on Linux
    • Install on Docker Desktop
  • Requirements
    • Technical Requirements
    • Network Requirements
    • URL Registration for GRAX
  • Architecture
    • Architecture
    • AWS Architecture Example
    • Azure Architecture Example
  • Other
    • Longterm Storage
    • Operating Costs
    • Monitoring
    • Rotating Infrastructure Secrets

Copyright © 2025 GRAX, Inc.

On this page
  • Installation Steps
  • Setup Docker Desktop
  • Get a GRAX Trial Key
  • Download and Configure GRAX Docker Compose Files
  • Start Up GRAX with Docker Compose
  • Resetting Everything

Was this helpful?

Export as PDF
  1. Install Guides

Install on Docker Desktop

Last updated 1 month ago

Was this helpful?

Installation Steps

Setup Docker Desktop

First download, install, and run .

Get a GRAX Trial Key

Next, sign into the 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 , unzip them, and configure it with your registration key.

export GRAX_REGISTRATION_KEY=<Paste from GRAX Platform>
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

docker-compose up -d

You can pause GRAX with:

docker-compose stop

And resume again with docker-compose up -d.

Resetting Everything

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.

You can destroy all Docker resources with:

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

After 30 seconds, GRAX is running alongside a database and storage service. You can go to the "Backend URL" from , e.g:

Then, sign into the , go to "Backends," and "Delete" your previously activated backend and registration key.

Docker Desktop
GRAX Platform
GRAX Docker Compose Files
GRAX Platform
https://comfortable-trade-78.secure.grax.io
GRAX Platform