README.md

   1
   2 | <small>CI Builds</small> | <small>Debian</small> | <small>macOS & Ubuntu/LTS</small> |
   3 |----------------------|:-----------------:|:-----------------------------:|
   4 | _fdroidserver_ | [![fdroidserver status on Debian](https://gitlab.com/fdroid/fdroidserver/badges/master/build.svg)](https://gitlab.com/fdroid/fdroidserver/builds) | [![fdroidserver status on macOS & Ubuntu/LTS](https://travis-ci.org/f-droid/fdroidserver.svg?branch=master)](https://travis-ci.org/f-droid/fdroidserver) |
   5 | _buildserver_ | [![buildserver status](https://jenkins.debian.net/job/reproducible_setup_fdroid_build_environment/badge/icon)](https://jenkins.debian.net/job/reproducible_setup_fdroid_build_environment) | |
   6 | _fdroid build --all_ | [![fdroid build all status](https://jenkins.debian.net/job/reproducible_fdroid_build_apps/badge/icon)](https://jenkins.debian.net/job/reproducible_fdroid_build_apps/) | |
   7
   8 # F-Droid Server
   9
  10 Server for [F-Droid](https://f-droid.org), the Free Software repository system
  11 for Android.
  12
  13 The F-Droid server tools provide various scripts and tools that are
  14 used to maintain the main
  15 [F-Droid application repository](https://f-droid.org/packages).  You
  16 can use these same tools to create your own additional or alternative
  17 repository for publishing, or to assist in creating, testing and
  18 submitting metadata to the main repository.
  19
  20 For documentation, please see <https://f-droid.org/docs/>, or you can
  21 find the source for the documentation in
  22 [fdroid/fdroid-website](https://gitlab.com/fdroid/fdroid-website).
  23
  24
  25 ### What is F-Droid?
  26
  27 F-Droid is an installable catalogue of FOSS (Free and Open Source Software)
  28 applications for the Android platform. The client makes it easy to browse,
  29 install, and keep track of updates on your device.
  30
  31
  32 ### Installing
  33
  34 There are many was to install _fdroidserver_, they are documented on
  35 the website:
  36 https://f-droid.org/docs/Installing_the_Server_and_Repo_Tools
  37
  38 All sorts of other documentation lives there as well.
  39
  40
  41 ### Drozer Scanner
  42
  43 There is a new feature under development that can scan any APK in a
  44 repo, or any build, using Drozer.  Drozer is a dynamic exploit
  45 scanner, it runs an app in the emulator and runs known exploits on it.
  46
  47 This setup requires specific versions of two Python modules:
  48 _docker-py_ 1.9.0 and _requests_ older than 2.11.  Other versions
  49 might cause the docker-py connection to break with the containers.
  50 Newer versions of docker-py might have this fixed already.
  51
  52 For Debian based distributions:
  53
  54         apt-get install libffi-dev libssl-dev python-docker