Browse files

Merge pull request #344 from hughes/master

Added instructions for s3-hosted PyPi repo
  • Loading branch information...
2 parents 5deddca + 78016d6 commit 383009ab27d4b96bd6b381cfeed696f5c6134a73 @kennethreitz committed Jan 8, 2014
Showing with 30 additions and 0 deletions.
  1. +30 −0 docs/shipping/packaging.rst
@@ -67,6 +67,36 @@ Chishop
written in django which allows you to register/upload with distutils and
install with easy_install/pip.
+S3-Hosted PyPi
+One simple option for a personal PyPi server is to use Amazon S3. A prerequisite for this is that you have an Amazon AWS account with an S3 bucket.
+1. **Install all your requirements from PyPi or another source**
+2. **Install pip2pi**
+* :code:`pip install git+`
+3. **Follow pip2pi README for pip2tgz and dir2pi commands**
+* :code:`pip2tgz packages/ YourPackage` (or :code:`pip2tgz packages/ -r requirements.txt`)
+* :code:`dir2pi packages/`
+4. **Upload the new files**
+* Use a client like Cyberduck to sync the entire :code:`packages` folder to your s3 bucket
+* Make sure you upload :code:`packages/simple/index.html` as well as all new files and directories
+5. **Fix new file permissions**
+* By default, when you upload new files to the S3 bucket, they will have the wrong permissions set.
+* Use the Amazon web console to set the READ permission of the files to EVERYONE.
+* If you get HTTP 403 when trying to install a package, make sure you've set the permissions correctly.
+6. **All done**
+* You can now your package with :code:`pip install --index-url=http://your-s3-bucket/packages/simple/ YourPackage`
For Linux Distributions

0 comments on commit 383009a

Please sign in to comment.