mirror of
https://gitlab.com/fdroid/fdroidserver.git
synced 2024-08-17 11:50:11 +02:00
The whole TeX manual has been folded into the new Jekyll-based website, so this is no longer needed at all.
96 lines
3.2 KiB
Markdown
96 lines
3.2 KiB
Markdown
# F-Droid Server
|
|
|
|
[![build status](https://gitlab.com/fdroid/fdroidserver/badges/master/build.svg)](https://gitlab.com/fdroid/fdroidserver/builds)
|
|
|
|
Server for [F-Droid](https://f-droid.org), the Free Software repository system
|
|
for Android.
|
|
|
|
The F-Droid server tools provide various scripts and tools that are used to
|
|
maintain the main [F-Droid application repository](https://f-droid.org/repository/browse).
|
|
You can use these same tools to create your own additional or alternative
|
|
repository for publishing, or to assist in creating, testing and submitting
|
|
metadata to the main repository.
|
|
|
|
For documentation, please see <https://f-droid.org/docs/>, or you can
|
|
find the source for the documentation in
|
|
[fdroid/fdroid-website](https://gitlab.com/fdroid/fdroid-website).
|
|
|
|
|
|
### What is F-Droid?
|
|
|
|
F-Droid is an installable catalogue of FOSS (Free and Open Source Software)
|
|
applications for the Android platform. The client makes it easy to browse,
|
|
install, and keep track of updates on your device.
|
|
|
|
### Installing
|
|
|
|
Note that only Python 3 is supported. We recommend version 3.4 or later.
|
|
|
|
The easiest way to install the `fdroidserver` tools is on Ubuntu, Mint or other
|
|
Ubuntu based distributions, you can install using:
|
|
|
|
sudo apt-get install fdroidserver
|
|
|
|
For older Ubuntu releases or to get the latest version, you can get
|
|
`fdroidserver` from the Guardian Project PPA (the signing key
|
|
fingerprint is `6B80 A842 07B3 0AC9 DEE2 35FE F50E ADDD 2234 F563`)
|
|
|
|
sudo add-apt-repository ppa:guardianproject/ppa
|
|
sudo apt-get update
|
|
sudo apt-get install fdroidserver
|
|
|
|
On OSX, `fdroidserver` is available from third party package managers,
|
|
like Homebrew, MacPorts, and Fink:
|
|
|
|
brew install fdroidserver
|
|
|
|
For Arch-Linux is a package in the AUR available. If you have installed
|
|
`yaourt` or something similiar, you can do:
|
|
|
|
yaourt -S fdroidserver
|
|
|
|
For any platform where Python's `easy_install` is an option (e.g. OSX
|
|
or Cygwin, you can use it:
|
|
|
|
sudo easy_install fdroidserver
|
|
|
|
Python's `pip` also works:
|
|
|
|
sudo pip3 install fdroidserver
|
|
|
|
The combination of `pyvenv` and `pip` is great for testing out the
|
|
latest versions of `fdroidserver`. Using `pip`, `fdroidserver` can
|
|
even be installed straight from git. First, make sure you have
|
|
installed the python header files, venv and pip. They should be
|
|
included in your OS's default package manager or you can install them
|
|
via other mechanisms like Brew/dnf/pacman/emerge/Fink/MacPorts.
|
|
|
|
For Debian based distributions:
|
|
|
|
apt-get install python3-dev python3-pip python3-venv libjpeg-dev zlib1g-dev
|
|
|
|
Then here's how to install:
|
|
|
|
git clone https://gitlab.com/fdroid/fdroidserver.git
|
|
cd fdroidserver
|
|
pyvenv env/
|
|
source env/bin/activate
|
|
pip3 install -e .
|
|
python3 setup.py install
|
|
|
|
|
|
### Drozer Scanner
|
|
|
|
There is a new feature under development that can scan any APK in a
|
|
repo, or any build, using Drozer. Drozer is a dynamic exploit
|
|
scanner, it runs an app in the emulator and runs known exploits on it.
|
|
|
|
This setup requires specific versions of two Python modules:
|
|
_docker-py_ 1.9.0 and _requests_ older than 2.11. Other versions
|
|
might cause the docker-py connection to break with the containers.
|
|
Newer versions of docker-py might have this fixed already.
|
|
|
|
For Debian based distributions:
|
|
|
|
apt-get install libffi-dev libssl-dev python-docker
|