diff --git a/README.md b/README.md index 9eb3c7eb532..e7daafe53bc 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,12 @@ Full documentation - including advanced installation docs - are available online You can use [Github Issues](https://github.com/progrium/dokku/issues), check [Troubleshooting](http://progrium.viewdocs.io/dokku/troubleshooting) in the documentation, or join us on [freenode in #dokku](https://webchat.freenode.net/?channels=%23dokku) +## Contribution + +After checking [Github Issues](https://github.com/progrium/dokku/issues), the [Troubleshooting Guide](http://progrium.viewdocs.io/dokku/troubleshooting) or having a chat with us on [freenode in #dokku](https://webchat.freenode.net/?channels=%23dokku), feel free to fork and create a Pull Request. + +While we may not merge your PR as is, they serve to start conversations and improve the general dokku experience for all users. + ## Sponsors Dokku is currently sponsored by the enterprise grade, multi-host PaaS project [Deis](http://deis.io/). diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index f8a2e23f510..d46f464f450 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -141,3 +141,31 @@ When specifying your port you may want to use something similar to: Please see https://github.com/progrium/dokku/issues/282 +*** + +__Symptom:__ Deployment fails because of slow internet connection, messages shows `gzip: stdin: unexpected end of file` + +__Solution:__ + +If you see output similar this when deploying: + +``` + Command: 'set -o pipefail; curl --fail --retry 3 --retry-delay 1 --connect-timeout 3 --max-time 30 https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/ruby-2.0.0-p451-default-cache.tgz -s -o - | tar zxf -' failed unexpectedly: + ! + ! gzip: stdin: unexpected end of file + ! tar: Unexpected EOF in archive + ! tar: Unexpected EOF in archive + ! tar: Error is not recoverable: exiting now +``` + +it might that the curl command that is supposed to fetch the buildpack (anything in the low megabyte file size range) takes too long to finish, due to slowish connection. To overwrite the default values (connection timeout: 3 seconds, total maximum time for operation: 30 seconds), edit `/home/dokku/ENV` like the following: + +``` +#/home/dokku/ENV +export CURL_TIMEOUT=600 +export CURL_CONNECT_TIMEOUT=30 +``` + +References +* https://github.com/progrium/dokku/issues/509 +* https://github.com/dokku-alt/dokku-alt/issues/169