by SectorLabs

GitHub Readme.md

Heroku Buildpack Subdir

License: MIT

Allows you to compose multiple buildpacks with apps in multiple directories. For information regarding adding multiple buildpacks, check out the official docs here.

This buildpack must be at index 1 and all buildpacks following should be at index 2 through N.


$ heroku buildpacks:set https://github.com/negativetwelve/heroku-buildpack-subdir

Example .buildpacks file:

$ cat .buildpacks

This would run:

  • The first buildpack would be in the root directory use use the nginx buildpack.
  • The second buildpack would cd into an api directory and use a ruby buildpack.
  • The third would cd into a web directory and use a nodejs buildpack.
  • The fourth would cd into a web directory and use a pgbouncer buildpack.
  • The firth would be in the root directory and use a go buildpack.

Buildpacks are executed in the order they are declared.

Experimental features

.profile.d scripts are left behind by buildpacks and are invoked by Heroku when the dyno is starting. This allows buildpacks to update the PATH environment for example. Since buildpacks can be ran in subdirectories, the .profile.d scripts left behind by these buildpacks are not invoked by Heroku.

Support for this recently landed in this buildpack but is still experimental. You can enable it by setting the SUBDIR_ENABLE_PROFILE_SOURCING setting on your Heroku app:


You can read more about the role of .profile.d scripts in the Heroku documentation:


Note: if you're using the Python or Node.js buildpack, you most likely want to enable this setting.