Next: , Previous: , Up: Top   [Contents][Index]


3 Setup

Because the tools and data will always change rapidly, you will almost certainly want to work from a git clone of the tools at this stage. To get started:

git clone git://gitorious.org/f-droid/fdroidserver.git

You now have lots of stuff in the fdroidserver directory, but the most important is the ’fdroid’ command script which you run to perform all tasks. This script is always run from a repository data directory, so the most sensible thing to do next is to put your new fdroidserver directory in your PATH.

3.1 Data

To do anything, you’ll need at least one repository data directory. It’s from this directory that you run the fdroid command to perform all repository management tasks. You can either create a brand new one, or grab a copy of the data used by the main F-Droid repository:

git clone git://gitorious.org/f-droid/fdroiddata.git

Regardless of the intended usage of the tools, you will always need to set up some basic configuration details. This is done by creating a file called config.py in the data directory. You should do this by copying the example file (config.sample.py) from the fdroidserver project to your data directory and then editing according to the instructions within.

Once configured in this way, all the functionality of the tools is accessed by running the fdroid command. Run it on its own to get a list of the available sub-commands.

You can follow any command with --help to get a list of additional options available for that command.

fdroid update --help

Next: , Previous: , Up: Top   [Contents][Index]