{"id":18370214,"url":"https://github.com/docwhat/rbenv-chef-workstation","last_synced_at":"2025-08-07T00:39:12.812Z","repository":{"id":46154449,"uuid":"160551914","full_name":"docwhat/rbenv-chef-workstation","owner":"docwhat","description":"rbenv plugin for chef-workstation","archived":false,"fork":false,"pushed_at":"2021-10-20T20:03:28.000Z","size":21,"stargazers_count":15,"open_issues_count":2,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T18:38:49.851Z","etag":null,"topics":["chef","chef-workstation","rbenv","rbenv-plugin","ruby"],"latest_commit_sha":null,"homepage":"","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/docwhat.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-12-05T17:07:37.000Z","updated_at":"2024-11-09T03:32:19.000Z","dependencies_parsed_at":"2022-09-05T07:11:48.418Z","dependency_job_id":null,"html_url":"https://github.com/docwhat/rbenv-chef-workstation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/docwhat/rbenv-chef-workstation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docwhat%2Frbenv-chef-workstation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docwhat%2Frbenv-chef-workstation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docwhat%2Frbenv-chef-workstation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docwhat%2Frbenv-chef-workstation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docwhat","download_url":"https://codeload.github.com/docwhat/rbenv-chef-workstation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docwhat%2Frbenv-chef-workstation/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269180932,"owners_count":24373838,"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","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chef","chef-workstation","rbenv","rbenv-plugin","ruby"],"created_at":"2024-11-05T23:37:25.110Z","updated_at":"2025-08-07T00:39:12.392Z","avatar_url":"https://github.com/docwhat.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rbenv-chef-workstation: Use Chef Workstation with rbenv\n\nThis plugin lets you treat [Chef Workstation](https://downloads.chef.io/chef-workstation/) as another version in [rbenv](http://rbenv.org/).\n\nChef Workstation replaces ChefDK. If you want to use ChefDK instead, then use the old [rbenv-chefdk plugin](https://github.com/docwhat/rbenv-chefdk) instead.\n\n## Requirements\n\n-   [Chef Workstation](https://downloads.chef.io/chef-workstation/) installed in `/opt/chef-workstation`\n\n## Installation\n\nTo install rbenv-chef-workstation, clone this repository into the `$(rbenv root)/plugins` directory.\n\n```sh\n$ cd $(rbenv root)/plugins\n$ git clone \u003curl\u003e\n```\n\n**Warning:** If you've previously installed Chef Workstation, you will want to undo the changes recommended in the [Chef Workstation install instructions](https://docs.chef.io/install_dk.html#set-system-ruby) or in the Homebrew info gist. Otherwise `rbenv` or Chef Workstation will not work correctly.\n\nThen create an empty directory in `$(rbenv root)/versions` called `chef-workstation`:\n\n```sh\n$ mkdir \"$(rbenv root)/versions/chef-workstation\"\n```\n\nFinally, change to the new `chef-workstation` version and run `rbenv rehash`.\n\n```sh\n$ rbenv shell chef-workstation\n$ rbenv rehash\n$ rbenv which ruby\n/opt/chef-workstation/embedded/bin/ruby\n```\n\nThat's it!\n\n## Troubleshooting\n\nIf you are having problems, try running `sanity-check.sh`:\n\n```sh\n$ $SHELL \"$(rbenv root)/plugins/rbenv-chef-workstation/sanity-check.sh\"\n```\n\n### Error running commands and errors talk about chefdk\n\nMake sure you have completely uninstalled chefdk:\n\n```sh\n# This removes old Gems and the rbenv-chefdk plugin.\n$ rm -rf ~/.chefdk \"$(rbenv root)/plugins/rbenv-chefdk\" \"$(rbenv root)/versions/chefdk\"\n```\n\n## Frequently Asked Questions\n\n### Hey, what happened to `gem`?\n\nWith the Chef Workstation you have to use `chef gem` instead.\n\n### Why don't you include `/opt/chef-workstation/embedded/bin`?\n\nWe don't fully include the `/opt/chef-workstation/embedded/bin` directory because it'll break your system in subtle ways.\n\n`/opt/chef-workstation/embedded/bin` has commands like `clear`, `tput`, `xsltproc`, and `xz`. These are commands that are part of your system and are only included in Chef Workstation so it gets reliable results across platforms.\n\nIf we made shims of these commands, your system might break when not using chef-workstation and can produce unexpected results even if you were using chef-workstation if your version of these commands are different (e.g. Gnu vs. BSD or version).\n\n### Why not just symlink `/opt/chef-workstation/embedded` to `$(rbenv root)/versions/chef-workstation`?\n\nFor the same reason we don't include `/opt/chef-workstation/embedded/bin`: It breaks systems commands in unexpected ways.\n\n### Rbenv isn't working or is using gems from the wrong place\n\nMake sure you undid any changes recommended by the [Chef Workstation install instructions](https://docs.chef.io/install_dk.html#set-system-ruby) or in the Homebrew info gist.\n\nSpecifically, make sure you aren't calling `chef shell-init` anyplace in your shell startup files.\n\n### \"can't find executable chef (Gem::Exception)\"\n\nThis is because you are using [`rbenv-bundle-exec`](https://github.com/maljub01/rbenv-bundle-exec).\n\nYou'll have to tell `rbenv-bundle-exec` to ignore a bunch of binaries that are only in Chef Workstation:\n\n```sh\necho chef \u003e\u003e ~/.no_bundle_exec\necho berks \u003e\u003e ~/.no_bundle_exec\n```\n\n## Questions?\n\nYou can reach me at [docwhat.org](https://docwhat.org/email/) or as docwhat on [Freenode IRC](https://freenode.net/).\n\n## License\n\nSee the `LICENSE` file\n\n## Note on Patches/Pull Requests\n\n-   Fork the project.\n-   Make your feature addition or bug fix.\n-   Add tests for it. This is important so I don't break it in a future version unintentionally.\n-   Commit\n-   Send me a pull request. Bonus points for topic branches.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocwhat%2Frbenv-chef-workstation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocwhat%2Frbenv-chef-workstation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocwhat%2Frbenv-chef-workstation/lists"}