You can help others deploy your project to Render by creating a **Deploy to Render** button, which looks like this:

After you add the Deploy to Render button to a `README` in your repo, users can click the button, review the services to be deployed on their Render account, and approve the deployment to set everything up instantly and without any additional work.

Follow these steps to add the button for your repo:

1. Create a [`render.yaml`](/content/docs/infrastructure-as-code/index.html) file describing the services you want to deploy from your repository.
2. Make sure your repository is accessible to your users.
   - Public repos are supported out of the box.
   - For private GitHub repos install [Render's GitHub App](https://github.com/apps/render) on your repo.
   - For private GitLab and Bitbucket repos, grant your users clone access to the repo.
3. Add the Deploy to Render button to your GitHub/GitLab/Bitbucket `README.md`.

```markdown

```

If you're not using Markdown for the `README` add an image from [https://render.com/images/deploy-to-render-button.svg](/content/images/deploy-to-render-button.svg) linking to [https://render.com/deploy](/content/deploy/index.html).

By default, Render uses the **referrer of the page** containing the Deploy to Render button to detect the repository to deploy. You can also explicitly specify a repository as shown below.

## Specifying a repository

It's strongly recommended that you append a `repo` query string parameter to the button's target URL. Without it, the Git repository URL is determined from the [`Referer`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referer) header, however many browsers no longer include the full URL in the `Referer` header due to [privacy and security concerns](https://developer.mozilla.org/en-US/docs/Web/Security/Referer_header:_privacy_and_security_concerns).

Set the value of `repo` to the full `https://` URL for your Git repo. Here's an example.

```html
<a
  href="https://render.com/deploy?repo=https://github.com/render-examples/mattermost"
>
  <img
    src="https://render.com/images/deploy-to-render-button.svg"
    alt="Deploy to Render"
  />
</a>
```

### Specifying a branch

By default the repo's default branch (normally `main` or `master`) is deployed. You can deploy a different branch by appending `/tree/branch_name` to the end of the `repo` query parameter. As an example, the link below will deploy a branch named `bugfix-123`.

```html
<a
  href="https://render.com/deploy?repo=https://github.com/render-examples/mattermost/tree/bugfix-123"
>
  <img
    src="https://render.com/images/deploy-to-render-button.svg"
    alt="Deploy to Render"
  />
</a>
```

## Configuring auto-deploys

When using the Deploy to Render button to deploy via a `render.yaml` Blueprint Spec contained in the service's repo, special consideration must be taken with regard to the service's [auto-deploy](/content/docs/deploys#configuring-auto-deploys/index.html) settings. For a service that is meant to be deployed via a Deploy to Render button, it is strongly advised to set `autoDeployTrigger: off` via the `render.yaml` [Blueprint Spec](/content/docs/blueprint-spec/index.html). This ensures that code pushes to the repo that contains the Deploy to Render button don't trigger an automatic deploy of every instance deployed via the Deploy to Render button.

## Button generator

Paste your GitHub/GitLab/Bitbucket repo URL to generate a Deploy to Render button as Markdown and HTML:

**Specifying a repo URL is strongly recommended.**

Without it, Render attempts to determine the URL from the [Referer](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referer) header. Many browsers no longer include the full URL in the Referer header due to [privacy and security concerns](https://developer.mozilla.org/en-US/docs/Web/Security/Referer_header:_privacy_and_security_concerns).

[Deploy to Render](/content/deploy/index.html)

### Markdown

```markdown

```

### HTML

```html
<a href="https://render.com/deploy">
  <img src="https://render.com/images/deploy-to-render-button.svg" alt="Deploy to Render">
</a>
```