{"id":21442115,"url":"https://github.com/gaffneyc/heroku-buildpack-tcmalloc","last_synced_at":"2025-07-14T17:32:42.071Z","repository":{"id":49210242,"uuid":"132035731","full_name":"gaffneyc/heroku-buildpack-tcmalloc","owner":"gaffneyc","description":"Easily install and use Google's TCMalloc on Heroku","archived":false,"fork":false,"pushed_at":"2021-06-23T14:55:27.000Z","size":8,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-04-12T04:16:10.163Z","etag":null,"topics":["heroku","heroku-buildpack","tcmalloc"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gaffneyc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-03T18:38:27.000Z","updated_at":"2022-10-27T20:05:18.000Z","dependencies_parsed_at":"2022-08-31T06:00:23.977Z","dependency_job_id":null,"html_url":"https://github.com/gaffneyc/heroku-buildpack-tcmalloc","commit_stats":null,"previous_names":[],"tags_count":4,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaffneyc%2Fheroku-buildpack-tcmalloc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaffneyc%2Fheroku-buildpack-tcmalloc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaffneyc%2Fheroku-buildpack-tcmalloc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaffneyc%2Fheroku-buildpack-tcmalloc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gaffneyc","download_url":"https://codeload.github.com/gaffneyc/heroku-buildpack-tcmalloc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225990481,"owners_count":17556153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["heroku","heroku-buildpack","tcmalloc"],"created_at":"2024-11-23T01:52:37.097Z","updated_at":"2024-11-23T01:52:37.795Z","avatar_url":"https://github.com/gaffneyc.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# heroku-buildpack-tcmalloc\n\n[TCMalloc](https://github.com/gperftools/gperftools) is a thread-caching malloc\nimplementation designed to reduce fragmentation in multithreaded applications.\nThis buildpack makes it easy to install and use TCMalloc on Heroku and\ncompatible platforms.\n\n## Install\n\n```console\nheroku buildpacks:add https://github.com/gaffneyc/heroku-buildpack-tcmalloc.git\ngit push heroku master\n```\n\n## Made possible by Dead Man's Snitch\n\nContinued development and support of the tcmalloc buildpack is sponsored by\n[Dead Man's Snitch](https://deadmanssnitch.com).\n\nEver been surprised that a critical recurring job was silently failing to run?\nWhether it's backups, cache clearing, sending invoices, or whatever your\napplication depends on, Dead Man's Snitch makes it easy to\n[monitor heroku scheduler](https://deadmanssnitch.com/docs/heroku) tasks or to add\n[cron job monitoring](https://deadmanssnitch.com/docs/cron-job-monitoring) to\nyour other services.\n\nGet started for free today with [Dead Man's Snitch on Heroku](https://elements.heroku.com/addons/deadmanssnitch)\n\n## Usage\n\n### Recommended\n\nSet the TCMALLOC_ENABLED config option to true and tcmalloc will be used for\nall commands run inside of your dynos.\n\n```console\nheroku config:set TCMALLOC_ENABLED=true\n```\n\n### Per dyno\n\nTo control when tcmalloc is configured on a per dyno basis use\n`tcmalloc.sh \u003ccmd\u003e` and ensure that TCMALLOC_ENABLED is unset.\n\nExample Procfile:\n```yaml\nweb: tcmalloc.sh bundle exec puma -C config/puma.rb\n```\n\n## Configuration\n\n### TCMALLOC_ENABLED\n\nSet this to true to automatically enable tcmalloc.\n\n```console\nheroku config:set TCMALLOC_ENABLED=true\n```\n\nTo disable tcmalloc set the option to false. This will cause the application to\nrestart disabling tcmalloc.\n\n```console\nheroku config:set TCMALLOC_ENABLED=false\n```\n\n### TCMALLOC_VERSION\n\nSet this to select or pin to a specific version of tcmalloc. The default is to\nuse the latest stable version if this is not set. You will receive an error\nmentioning tar if the version does not exist.\n\n**Default**: `2.7`\n\n**note:** This setting is only used during slug compilation. Changing it will\nrequire a code change to be deployed in order to take affect.\n\n```console\nheroku config:set TCMALLOC_VERSION=2.7\n```\n\n#### Available Versions\n\n| Version                                                                         | Released   |\n| ------------------------------------------------------------------------------- | ---------- |\n| [2.7](https://github.com/gperftools/gperftools/releases/tag/gperftools-2.7)     | 2018-04-30 |\n| [2.8](https://github.com/gperftools/gperftools/releases/tag/gperftools-2.8)     | 2020-07-06 |\n| [2.8.1](https://github.com/gperftools/gperftools/releases/tag/gperftools-2.8.1) | 2020-12-21 |\n| [2.9](https://github.com/gperftools/gperftools/releases/tag/gperftools-2.9)     | 2021-02-21 |\n| [2.9.1](https://github.com/gperftools/gperftools/releases/tag/gperftools-2.9.1) | 2021-03-02 |\n\nThe complete and most up to date list of supported versions and stacks is\navailable on the [releases page.](https://github.com/gaffneyc/heroku-buildpack-tcmalloc/releases)\n\n## Building\n\nThis uses Docker to build against Heroku\n[stack-image](https://github.com/heroku/stack-images)-like images.\n\n```console\nmake VERSION=2.7\n```\n\nArtifacts will be dropped in `dist/` based on Heroku stack and tcmalloc version.\n\n### Deploying New Versions\n\n- `make VERSION=X.Y.Z`\n- `open dist`\n- Go to [releases](https://github.com/gaffneyc/heroku-buildpack-tcmalloc/releases)\n- Edit the release corresponding to each heroku Stack\n- Drag and drop the new build to attach\n\n### Creating a New Stack\n- Go to [releases](https://github.com/gaffneyc/heroku-buildpack-tcmalloc/releases)\n- Click \"Draft a new release\"\n- Tag is the name of the Stack (e.g. `heroku-18`)\n- Target is `release-master`\n- Title is `Builds for the [stack] stack`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaffneyc%2Fheroku-buildpack-tcmalloc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaffneyc%2Fheroku-buildpack-tcmalloc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaffneyc%2Fheroku-buildpack-tcmalloc/lists"}