> For the complete documentation index, see [llms.txt](https://docs.squidex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.squidex.io/id-01-getting-started/installation/platforms/install-on-heroku.md).

# Install on Heroku

Install on Heroku

## 1. Use the 1-Click Deploy Button

[![Deploy to Heroku](https://img.shields.io/badge/-Deploy%20to%20Heroku-430098?style=for-the-badge\&logo=heroku\&logoColor=ffffff)](https://heroku.com/deploy?template=https://github.com/Squidex/squidex)

## 2. Fill in the details

Make sure that you fill in the **App name** (1) field with something unique, and then fill the **DOMAIN** (2) variable with the external domain you want your Squidex instance to be available on.

You can ignore *MONGO\_USERNAME* and *MONGO\_PASSWORD* for now.

![Fill Details](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-b0fada4fa5228db603834dbcf1f60d38104fb830%2Fheroku-2.png?alt=media)

When you are done, click **Deploy App**.

## 3. Wait for the Deployment to Complete

![Deployment Started](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-d401d13254b967cc4b7b3130b9efab00b6cdbd00%2Fheroku-3-1.png?alt=media)

![Deployment Finished](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-a9c250570722ccb039640d922c64f5cf19a83536%2Fheroku-3-2.png?alt=media)

When it's finished, click **Manage app** (1).

## 4. Create MongoDB database and credentials

On the Dashboard, click **ObjectRocket for MongoDB** (1)**.**

![Open ObjectRocket Dashboard](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-01f68ae9de8faeb8ce5f9286e967b90601dc72f8%2Fheroku-4-1.png?alt=media)

On the ObjectRocket Dashboard, click **DATABASES** (1) and then **Add Database** (2).

![Open Databases](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-3654b35b4f8ea71f991a80eeac6a6f7130e5a781%2Fheroku-4-2.png?alt=media)

Enter the **database name** (1) (must be `squidex`), the **Username** and the **Password** (2). Keep note of those, as you will need them for the next step.

![Create Database](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-e72571c05bfa98f6678e3743b0ffd25ef3b98cce%2Fheroku-4-3.png?alt=media)

## 5. Fill In the Database Credentials

Back at the Heroku Dashboard, click **Settings** (1), then click **Reveal Config Vars** (2).

![Settings](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-c71873ca1cc357ffa51e3d514fd842a197f28b06%2Fheroku-5-1.png?alt=media)

Fill the fields `MONGO_PASSWORD` (1) and `MONGO_USERNAME` (2) with the same credentials you provided in the previous step.

![Config Vars](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-1fc88ca7800f8b9469d3cad54c278e51863a8c4e%2Fheroku-5-2.png?alt=media)

You should then be ready to go!

## Troubleshooting

Please check the logs by clicking **More**, and then **View logs.**

![Logs](https://2730255609-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LrL94QfeasZ0wF6YAvB%2Fuploads%2Fgit-blob-3bf5a03f7851a73fbe5b701b7c4fc938dea97c14%2Fheroku-troubleshooting.png?alt=media)

### Restart Dynos

In case the deployment gets stuck, go to the top right of the dashboard, click **More** and then **Restart all dynos**.

### More issues?

For other issues, it is likely that you have a configuration problem not related to hosting under Heroku. Checkout the following documentation:

{% content-ref url="/pages/-LrLSGJjFug4kUmNpB9G" %}
[Configuration](/id-01-getting-started/installation/configuration.md)
{% endcontent-ref %}