Installation from source

Requirements

RestAuth is written as a bleeding edge project and thus requires relatively new software versions.

Note

Although Django itself still supports Python 2.5, RestAuth is only compatible with Python 2.6 or later.

Get source

From git

This project is developed on git.fsinf.at. You can view the source code at git.fsinf.at/restauth/server. To clone the repository to a directory named “RestAuth”, simply do:

git clone http://git.fsinf.at/restauth/server.git RestAuth

Older versions are marked as tags. You can view available tags with git tag -l. You can use any of those versions with git checkout, for example git checkout 1.0. To move back to the newest version, use git checkout master.

If you ever want to update the source code, just use:

python setup.py clean
git pull

... and do the same as if you where doing a new installation.

Official releases

You can download official releases of RestAuth here. The latest release is version 0.5.2.

Installation

Installation itself is very easy. Just go to the directory where your source is located (“RestAuth” in the above example) and run:

python setup.py build
python setup.py install

Once you have installed RestAuth, you can go on configuring your webserver and configuring RestAuth.

Run tests

RestAuth features an extensive test suite. You can run those tests using:

python setup.py test

Note that you can run these tests even if you already installed RestAuth or locally configured your RestAuth installation. The tests will always use their own temporary database.

Build documentation

To generate the most recent documentation (the newest version of the document you’re currently reading), just run:

python setup.py build_doc

Table Of Contents

Previous topic

Welcome to RestAuth!

Next topic

Installation on Debian/Ubuntu

This Page