You can just call me choco.
Come join in the conversation about Chocolatey in our Community Chat Room.
Please make sure you've read over and agree with the etiquette regarding communication.
Chocolatey FOSS install showing tab completion and
refreshenv (a way to update environment variables without restarting your shell):
Chocolatey Pro showing private CDN download cache and virus scan protection:
If you are an open source user requesting support, please remember that most folks in the Chocolatey community are volunteers that have lives outside of open source and are not paid to ensure things work for you, so please be considerate of others' time when you are asking for things. Many of us have families that also need time as well and only have so much time to give on a daily basis. A little consideration and patience can go a long way. After all, you are using a pretty good tool without cost. It may not be perfect (yet), and we know that.
Please see the docs
choco.exe -? a shot (or
choco.exe -h). For specific commands, add the command and then the help switch e.g.
choco.exe install -h.
Observe the following help for submitting an issue:
Submitting a ticket:
--debug --verbose. You can submit that with the issue or create a gist and link it.
$env:ChocolateyInstall\log\. You can grab the specific log output from there so you don't have to capture or redirect screen output. Please limit the amount included to just the command run (the log is appended to with every command).
log.sh) and link to the gist from the issue. Feel free to create it as secret so it doesn't fill up against your public gists. Anyone with a direct link can still get to secret gists. If you accidentally include secret information in your gist, please delete it and create a new one (gist history can be seen by anyone) and update the link in the ticket (issue history is not retained except by email - deleting the gist ensures that no one can get to it). Using gists this way also keeps accidental secrets from being shared in the ticket in the first place as well.
If you would like to contribute code or help squash a bug or two, that's awesome. Please familiarize yourself with CONTRIBUTING.
Committers, you should be very familiar with COMMITTERS.
There is a
build.sh file that creates a necessary generated file named
SolutionVersion.cs. It must be run at least once before Visual Studio will build.
.sln.DotSettingsfile to help with code conventions).
Running the build on Windows should produce an artifact that is tested and ready to be used.
# install prerequisites sudo apt install apt-transport-https dirmngr gnupg ca-certificates # add the key sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF # add the package repository # Debian 10 echo "deb https://download.mono-project.com/repo/debian stable-buster main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list # Debian 9 echo "deb https://download.mono-project.com/repo/debian stable-stretch main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list #Ubuntu 20.04 echo "deb https://download.mono-project.com/repo/ubuntu stable-focal main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list # Ubuntu 18.04 echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list # Ubuntu 16.04 echo "deb https://download.mono-project.com/repo/ubuntu stable-xenial main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list # update package indexes sudo apt-get update # install sudo apt-get install mono-devel -y
~/.profile(or other relevant dot source file):
# mono # http://www.michaelruck.de/2010/03/solving-pkg-config-and-mono-35-profile.html # https://cloudgen.wordpress.com/2013/03/06/configure-nant-to-run-under-mono-3-06-beta-for-mac-osx/ export PKG_CONFIG_PATH=/opt/local/lib/pkgconfig:/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig:$PKG_CONFIG_PATH
chmod +x build.sh chmod +x zip.sh
Running the build on Mono produces an artifact similar to Windows but may have more rough edges. You may get a failure or two in the build script that can be safely ignored.
./code_drop/temp/_PublishedApps/chocoto your preferred install directory. On Linux, the preferred directory is
ChocolateyInstallenvironment variable, pointing to the install directory the build output was copied too.
./docker/choco_wrapperto a directory on the
$PATH, rename to
choco, and if the install directory is something else than
/opt/chocolatey, then edit it to point to the correct path.
Chocolatey is brought to you by quite a few people and frameworks. See CREDITS (just LEGAL/Credits.md in the zip folder).