You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If you have a question about the _package_, please follow **both** these steps:
14
14
@@ -17,13 +17,13 @@ If you have a question about the _package_, please follow **both** these steps:
17
17
18
18
19
19
20
-
###How Do I Ask Questions About the Package Software?
20
+
## How Do I Ask Questions About the Package Software?
21
21
22
22
If you have questions about the _software_ the package installs, please contact the Software Vendor/Author. Maintainers do not provide support for the software that is packaged.
23
23
24
24
If you want to ask questions about the _package_, see [here](#how-do-i-ask-questions-about-a-package).
25
25
26
-
###How Do I Contact the Package Maintainers?
26
+
## How Do I Contact the Package Maintainers?
27
27
28
28
You may want to contact the package maintainers with package questions, or to report a broken or outdated package. On the [Chocolatey Community Repository](https://community.chocolatey.org/packages) package page, click the **Contact Maintainers** link.
29
29
@@ -33,7 +33,7 @@ If your question is about the software installed by the package, please contact
33
33
34
34
35
35
36
-
###How Do I Contact the Site Admins?
36
+
## How Do I Contact the Site Admins?
37
37
38
38
You should contact the Site Admins if:
39
39
@@ -52,11 +52,11 @@ To contact the Site Admins, click the **Contact Site Admins** link to contact th
52
52
53
53
54
54
55
-
###How Do I Create Chocolatey Packages?
55
+
## How Do I Create Chocolatey Packages?
56
56
57
57
It's easy to <Xreftitle="create and maintain packages"value="create-packages" />.
58
58
59
-
###How Do I Find the Package Source?
59
+
## How Do I Find the Package Source?
60
60
61
61
On the [Chocolatey Community Repository](https://community.chocolatey.org/packages) package page, click the **Package Source** link, if it's available.
62
62
@@ -67,7 +67,7 @@ Not all Maintainers provide a publicly accessible package source. If the **Packa
67
67
68
68
69
69
70
-
###How Do I Inspect the Contents of a Chocolatey Package?
70
+
## How Do I Inspect the Contents of a Chocolatey Package?
71
71
72
72
<Callouttype="info">
73
73
Packages submitted before 2014 do not have files listed under the **Files** section.
@@ -81,23 +81,23 @@ You can also download the actual package and inspect the contents. On the left m
81
81
82
82
83
83
84
-
###How Do I See All Versions Of a Package
84
+
## How Do I See All Versions Of a Package
85
85
86
86
Packages can have multiple version, both stable and prerelease. All of these versions are listed on the package page and can be found by scrolling down the page to the **Version History** section and clicking the link.
87
87
88
88
89
89
90
90
Only a limited number are shown initially. If there are more version available, click the **Show Additional Versions** button to view them all.
91
91
92
-
###How Do I See the Package Source Code?
92
+
## How Do I See the Package Source Code?
93
93
94
94
See [this FAQ question](#how-do-i-find-the-package-source).
95
95
96
-
###How To Report An Abusive Package
96
+
## How To Report An Abusive Package
97
97
98
98
<Callouttype="info">
99
99
Do not use the **Report Abuse** form to submit reports of:
100
-
100
+
101
101
* <Xreftitle="A package being outdated"value="package-triage-process"anchor="package-is-outdated" />.
102
102
* <Xreftitle="A package being broken or not working"value="package-triage-process"anchor="package-is-broken" />.
103
103
* Marketing or sales communications.
@@ -117,32 +117,6 @@ If a package is abusive, please report it by clicking on the **Report Abuse** li
117
117
118
118
119
119
120
-
### Why do I get a 500 Internal Server Error when trying to push my package?
121
-
122
-
If you receive a `500 Internal Server Error` when pushing a package, you may have a malformed package that the server was unable to process.
123
-
One such case is documented in a [GitHub issue](https://github.com/chocolatey/home/issues/303).
124
-
125
-
Make sure that none of the `<file ...>` entries in the `nuspec` file of your package have name collisions with other files or folders being packed.
126
-
This is usually rare but can be encountered more commonly if you are trying to pack files which don't have a file extension.
127
-
For example, if you have `<file>` entries that may look like this, you will need to change the name of the file or folder in the package to avoid collision:
128
-
129
-
```xml
130
-
<filesrc="bin\*"target="bin" />
131
-
<filesrc="file-with-no-extension"target="bin" />
132
-
```
133
-
134
-
There are two possible solutions for this particular case:
135
-
136
-
```xml
137
-
<!-- option 1: rename the file to have a file extension -->
138
-
<filesrc="bin\*"target="bin" />
139
-
<filesrc="file-with.extension"target="bin" />
140
-
141
-
<!-- option 2: specify the full path to the file in the package as the target, instead of just the folder name -->
See an [issue we raised on the NuGet repository](https://github.com/NuGet/Home/issues/13273) for more information on the NuGet bug which can cause this kind of malformed package.
120
+
## Why do I get a 500 Internal Server Error when trying to push my package?
147
121
148
-
If you receive a `500: Internal Server Error` that is not related to this specific case, please [file an issue on GitHub](https://github.com/chocolatey/home) so we can investigate the issue.
122
+
<Xreftitle="See the Chocolatey Community Repository Common Errors page"value="ccr-common-errors"anchor="error-500-internal-server-error" />.
Once you've pushed a package to the Chocolatey Community Repository, Chocolatey CLI will report if it was successful or not. If for any reason it's not successful, it will report the error code and any response that it received. Sometimes the error text is not fully received due to various network issues. Below is a list of HTTP responses and what it could mean.
14
+
15
+
## Error 400 Bad Request
16
+
17
+
Can occur if the API Key is not a correctly formatted GUID, or the package you've attempted to push contains a non-normalized version number.
18
+
19
+
## Error 403 Unauthorized
20
+
21
+
There are a number of causes for the 403 error. Some common cases:
22
+
23
+
- Invalid API Key.
24
+
- Package is not owned by the user pushing the package.
25
+
- Package has a version in moderation and no approved versions.
26
+
- Package has too many existing versions in moderation.
27
+
- Package name is forbidden.
28
+
29
+
## Error 409 Conflict
30
+
31
+
There are 3 instances where this error could occur:
32
+
33
+
- Package and package version already exists and cannot be pushed again.
34
+
- Package failed some basic validations such as the title or description are too long.
35
+
- Some other unidentified error has occurred.
36
+
37
+
## Error 413 Request too large
38
+
39
+
Package is too large.
40
+
41
+
## Error 500 Internal Server Error
42
+
43
+
If you receive a `500 Internal Server Error` when pushing a package, you may have a malformed package that the server was unable to process.
44
+
One such case is documented in this [GitHub issue](https://github.com/chocolatey/home/issues/303).
45
+
46
+
Make sure that none of the `<file ...>` entries in the `nuspec` file of your package have name collisions with other files or folders being packed.
47
+
This is usually rare but can be encountered more commonly if you are trying to pack files which don't have a file extension.
48
+
For example, if you have `<file>` entries that may look like this, you will need to change the name of the file or folder in the package to avoid collision:
49
+
50
+
```xml
51
+
<filesrc="bin\*"target="bin" />
52
+
<filesrc="file-with-no-extension"target="bin" />
53
+
```
54
+
55
+
There are two possible solutions for this particular case:
56
+
57
+
```xml
58
+
<!-- option 1: rename the file to have a file extension -->
59
+
<filesrc="bin\*"target="bin" />
60
+
<filesrc="file-with.extension"target="bin" />
61
+
62
+
<!-- option 2: specify the full path to the file in the package as the target, instead of just the folder name -->
See an [issue we raised on the NuGet repository](https://github.com/NuGet/Home/issues/13273) for more information on the NuGet bug which can cause this kind of malformed package.
68
+
69
+
If you receive a `500: Internal Server Error` that is not related to this specific case, please [file an issue on GitHub](https://github.com/chocolatey/home) so we can investigate the issue.
0 commit comments