# Install on Heroku

Heroku is a PaaS (Platform as a Service) that allows you to deploy applications without worrying about the underlying infrastructure.

The trial installation includes all of the resources needed to enable GRAX backups and the GRAX datalake.

If you are new to GRAX, we recommend starting with the trial as you can always upgrade and migrate resources and data later.

If you are setting up GRAX for production, we recommend deploying GRAX to Heroku [via the GRAX Platform](/platform/connections/heroku-connection.md).

## Trial Installation

To quickly and easily deploy a GRAX trial on Heroku click the "Deploy to Heroku" button below:

[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.png)](https://www.heroku.com/deploy/?template=https://github.com/graxinc/grax-heroku-v2/tree/main)

This will provision the following resources:

1. A Heroku dyno with the GRAX Application
2. A Heroku Postgresql Add-on for GRAX Application state
3. An S3 Storage Add-on for CRM data
4. A GRAX Add-on to setup the datalake

![Heroku button resources](/files/ldy6xpXCqTBzdtfp9RQi)

## Maintenance

The GRAX Application installed on Heroku takes advantage of GRAX's automatic update tools, meaning that it automatically updates to the latest version of GRAX every day. This ensures that you always have the latest features and bug fixes without needing to manually update the application. Short of configuration changes or database maintenance, you should not need to interact with the Heroku application directly.

## Accessing the Application

By default, Heroku applications generate a random URL at which the application will be hosted. This can be discovered by clicking the "Open App" button on the Heroku application's dashboard. If you are interested in setting up a custom domain, this can be accomplished via the Heroku application's "settings" page whenever you'd like.


---

# 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/readme.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.