swift/doc/source/getting_started.rst

Getting Started

System Requirements

Swift development currently targets Ubuntu Server 14.04, but should work on most Linux platforms with the following software:

• Python 2.6 or 2.7
• rsync 3.0

And the following python libraries:

• Eventlet 0.9.15
• Setuptools
• Simplejson
• Xattr
• Nose
• Sphinx
• Netifaces
• Dnspython
• Pastedeploy

Getting Swift

Swift's source code is hosted on github and managed with git. The current trunk can be checked out like this:

git clone https://github.com/openstack/swift.git

A source tarball for the latest release of Swift is available on the launchpad project page.

Prebuilt packages for Ubuntu are available starting with Natty, or from PPAs for earlier releases.

• Swift Ubuntu Packages
• Swift PPA Archive

Development

To get started with development with Swift, or to just play around, the following docs will be useful:

• Swift All in One <development_saio> - Set up a VM with Swift installed
• Development Guidelines <development_guidelines>

Production

If you want to set up and configure Swift for a production cluster, the following doc should be useful:

• Multiple Server Swift Installation <howto_installmultinode>