f256440 Jul 24, 2015
@mludvig @taz77 @mdomsch
108 lines (74 sloc) 3.05 KB
Installation of s3cmd package
TGRMN Software and contributors
S3tools / S3cmd project homepage:
!!! Please consult README file for setup, usage and examples!
Package formats
S3cmd is distributed in two formats:
1) Prebuilt RPM file - should work on most RPM-based
2) Source .tar.gz package
Installation of RPM package
As user "root" run:
rpm -ivh s3cmd-X.Y.Z.noarch.rpm
where X.Y.Z is the most recent s3cmd release version.
You may be informed about missing dependencies
on Python or some libraries. Please consult your
distribution documentation on ways to solve the problem.
Installation from PyPA (Python Package Authority)
S3cmd can be installed from the PyPA using PIP (the recommended tool for PyPA).
1) Confirm you have PIP installed. PIP home page is here:
Example install on a RHEL yum based machine
sudo yum install python-pip
2) Install with pip
sudo pip install s3cmd
Installation from zip file
There are three options to run s3cmd from source tarball:
1) The S3cmd program, as distributed in s3cmd-X.Y.Z.tar.gz
on SourceForge or in on GitHub, can be run directly
from where you unzipped the package.
2) Or you may want to move "s3cmd" file and "S3" subdirectory
to some other path. Make sure that "S3" subdirectory ends up
in the same place where you move the "s3cmd" file.
For instance if you decide to move s3cmd to you $HOME/bin
you will have $HOME/bin/s3cmd file and $HOME/bin/S3 directory
with a number of support files.
3) The cleanest and most recommended approach is to unzip the
package and then just run:
python install
You will however need Python "distutils" module for this to
work. It is often part of the core python package (e.g. in
OpenSuse Python 2.5 package) or it can be installed using your
package manager, e.g. in Debian use
apt-get install python-setuptools
Again, consult your distribution documentation on how to
find out the actual package name and how to install it then.
Note that on Linux, if you are not "root" already, you may
need to run:
sudo python install
Note to distributions package maintainers
Define shell environment variable S3CMD_PACKAGING=yes if you
don't want to install manpages and doc files. You'll
have to install them manually in your .spec or similar package
build scripts.
On the other hand if you want to install manpages
and docs, but to other than default path, define env
out for details and default values.
Where to get help
If in doubt, or if something doesn't work as expected,
get back to us via mailing list:
or visit the S3cmd / S3tools homepage at: