config.py 9.51 KB
Newer Older
1
#!/usr/bin/env python2
2
# -*- coding: utf-8 -*-
3

4 5
# Copy this file to config.py, then amend the settings below according to
# your system configuration.
Ciaran Gultnieks's avatar
Ciaran Gultnieks committed
6

7
# Custom path to the Android SDK, defaults to $ANDROID_HOME
Daniel Martí's avatar
Daniel Martí committed
8
# sdk_path = "$ANDROID_HOME"
9 10

# Custom paths to various versions of the Android NDK, defaults to 'r10e' set
11 12
# to $ANDROID_NDK. Most users will have the latest at $ANDROID_NDK, which is
# used by default. If a version is missing or assigned to None, it is assumed
13 14
# not installed.
# ndk_paths = {
15 16
#     'r9b': None,
#     'r10e': "$ANDROID_NDK",
17
# }
18

19 20 21 22 23 24 25
# If you want to build apps that use retrolambda and Java 1.8, you'll need to
# have both 1.7 and 1.8 installed.
# java_paths = {
#     '1.7': "/usr/lib/jvm/java-7-openjdk",
#     '1.8': None,
# }

26
# Build tools version to be used
Daniel Martí's avatar
Daniel Martí committed
27
# build_tools = "23.0.2"
28

29
# Command or path to binary for running Ant
30
# ant = "ant"
31

32
# Command or path to binary for running maven 3
33
# mvn3 = "mvn"
Daniel Martí's avatar
Daniel Martí committed
34

35
# Command or path to binary for running Gradle
36
# gradle = "gradle"
37

38 39 40 41 42
# Set the maximum age (in days) of an index that a client should accept from
# this repo. Setting it to 0 or not setting it at all disables this
# functionality. If you do set this to a non-zero value, you need to ensure
# that your index is updated much more frequently than the specified interval.
# The same policy is applied to the archive repo, if there is one.
43
# repo_maxage = 0
44

45
repo_url = "https://MyFirstFDroidRepo.org/fdroid/repo"
46
repo_name = "My First F-Droid Repo Demo"
Ciaran Gultnieks's avatar
Ciaran Gultnieks committed
47
repo_icon = "fdroid-icon.png"
48
repo_description = """
49
This is a repository of apps to be used with F-Droid. Applications in this
50 51 52 53
repository are either official binaries built by the original application
developers, or are binaries built from source by the admin of f-droid.org
using the tools on https://gitlab.com/u/fdroid.
"""
Ciaran Gultnieks's avatar
Ciaran Gultnieks committed
54

55 56 57 58 59 60
# As above, but for the archive repo.
# archive_older sets the number of versions kept in the main repo, with all
# older ones going to the archive. Set it to 0, and there will be no archive
# repository, and no need to define the other archive_ values.
archive_older = 3
archive_url = "https://f-droid.org/archive"
61
archive_name = "My First F-Droid Archive Demo"
62
archive_icon = "fdroid-icon.png"
63 64 65
archive_description = """
The repository of older versions of applications from the main demo repository.
"""
66

67
# Normally, all apps are collected into a single app repository, like on
68 69
# https://f-droid.org. For certain situations, it is better to make a repo
# that is made up of APKs only from a single app. For example, an automated
70 71 72
# build server that publishes nightly builds.
# per_app_repos = True

73
# `fdroid update` will create a link to the current version of a given app.
74
# This provides a static path to the current APK. To disable the creation of
75 76 77 78
# this link, uncomment this:
# make_current_version_link = False

# By default, the "current version" link will be based on the "Name" of the
79
# app from the metadata. You can change it to use a different field from the
80 81
# metadata here:
# current_version_name_source = 'id'
82

83 84 85
# Optionally, override home directory for gpg
# gpghome = /home/fdroid/somewhere/else/.gnupg

86
# The ID of a GPG key for making detached signatures for apks. Optional.
Daniel Martí's avatar
Daniel Martí committed
87
# gpgkey = '1DBA2E89'
88

89
# The key (from the keystore defined below) to be used for signing the
90 91
# repository itself. This is the same name you would give to keytool or
# jarsigner using -alias. (Not needed in an unsigned repository).
Daniel Martí's avatar
Daniel Martí committed
92
# repo_keyalias = "fdroidrepo"
93

94 95 96 97 98 99 100
# Optionally, the public key for the key defined by repo_keyalias above can
# be specified here. There is no need to do this, as the public key can and
# will be retrieved from the keystore when needed. However, specifying it
# manually can allow some processing to take place without access to the
# keystore.
# repo_pubkey = "..."

101 102 103
# The keystore to use for release keys when building. This needs to be
# somewhere safe and secure, and backed up!  The best way to manage these
# sensitive keys is to use a "smartcard" (aka Hardware Security Module). To
104
# configure F-Droid to use a smartcard, set the keystore file using the keyword
105
# "NONE" (i.e. keystore = "NONE"). That makes Java find the keystore on the
106
# smartcard based on 'smartcardoptions' below.
Daniel Martí's avatar
Daniel Martí committed
107
# keystore = "~/.local/share/fdroidserver/keystore.jks"
108 109 110

# You should not need to change these at all, unless you have a very
# customized setup for using smartcards in Java with keytool/jarsigner
Daniel Martí's avatar
Daniel Martí committed
111
# smartcardoptions = "-storetype PKCS11 -providerName SunPKCS11-OpenSC \
112 113
#    -providerClass sun.security.pkcs11.SunPKCS11 \
#    -providerArg opensc-fdroid.cfg"
114

115
# The password for the keystore (at least 6 characters). If this password is
116
# different than the keypass below, it can be OK to store the password in this
117
# file for real use. But in general, sensitive passwords should not be stored
118
# in text files!
Daniel Martí's avatar
Daniel Martí committed
119
# keystorepass = "password1"
120 121

# The password for keys - the same is used for each auto-generated key as well
122
# as for the repository key. You should not normally store this password in a
123
# file since it is a sensitive password.
Daniel Martí's avatar
Daniel Martí committed
124
# keypass = "password2"
125

Daniel Martí's avatar
Daniel Martí committed
126
# The distinguished name used for all keys.
127
# keydname = "CN=Birdman, OU=Cell, O=Alcatraz, L=Alcatraz, S=California, C=US"
128

Daniel Martí's avatar
Daniel Martí committed
129 130
# Use this to override the auto-generated key aliases with specific ones
# for particular applications. Normally, just leave it empty.
131 132
# keyaliases = {}
# keyaliases['com.example.app'] = 'example'
Daniel Martí's avatar
Daniel Martí committed
133 134
# You can also force an app to use the same key alias as another one, using
# the @ prefix.
135
# keyaliases['com.example.another.plugin'] = '@com.example.another'
136

137

138
# The full path to the root of the repository. It must be specified in
139
# rsync/ssh format for a remote host/path. This is used for syncing a locally
140
# generated repo to the server that is it hosted on. It must end in the
141
# standard public repo name of "/fdroid", but can be in up to three levels of
142
# sub-directories (i.e. /var/www/packagerepos/fdroid). You can include
143 144
# multiple servers to sync to by wrapping the whole thing in {} or [], and
# including the serverwebroot strings in a comma-separated list.
145
#
Daniel Martí's avatar
Daniel Martí committed
146
# serverwebroot = '[email protected]:/var/www/fdroid'
147 148 149 150
# serverwebroot = {
#     'foo.com:/usr/share/nginx/www/fdroid',
#     'bar.info:/var/www/fdroid',
#     }
151

152 153 154 155 156 157 158 159 160 161 162 163
# Any mirrors of this repo, for example all of the servers declared in
# serverwebroot, will automatically be used by the client.  If one
# mirror is not working, then the client will try another.  If the
# client has Tor enabled, then the client will prefer mirrors with
# .onion addresses. This base URL will be used for both the main repo
# and the archive, if it is enabled.  So these URLs should end in the
# 'fdroid' base of the F-Droid part of the web server like serverwebroot.
#
# mirrors = {
#     'https://foo.bar/fdroid',
#     'http://foobarfoobarfoobar.onion/fdroid',
# }
164

165
# optionally specific which identity file to use when using rsync over SSH
166
#
167 168
# identity_file = '~/.ssh/fdroid_id_rsa'

169 170 171

# If you are running the repo signing process on a completely offline machine,
# which provides the best security, then you can specify a folder to sync the
172 173 174
# repo to when running `fdroid server update`. This is most likely going to
# be a USB thumb drive, SD Card, or some other kind of removable media. Make
# sure it is mounted before running `fdroid server update`. Using the
175 176 177 178 179 180
# standard folder called 'fdroid' as the specified folder is recommended, like
# with serverwebroot.
#
# local_copy_dir = '/media/MyUSBThumbDrive/fdroid'


181 182
# If you are using local_copy_dir on an offline build/signing server, once the
# thumb drive has been plugged into the online machine, it will need to be
183
# synced to the copy on the online machine. To make that happen
184 185 186 187 188
# automatically, set sync_from_local_copy_dir to True:
#
# sync_from_local_copy_dir = True


189 190 191 192 193
# To upload the repo to an Amazon S3 bucket using `fdroid server update`.
# Warning, this deletes and recreates the whole fdroid/ directory each
# time. This is based on apache-libcloud, which supports basically all cloud
# storage services, so it should be easy to port the fdroid server tools to
# any of them.
194
#
Daniel Martí's avatar
Daniel Martí committed
195 196 197
# awsbucket = 'myawsfdroid'
# awsaccesskeyid = 'SEE0CHAITHEIMAUR2USA'
# awssecretkey = 'yourverysecretkeywordpassphraserighthere'
198

199

200
# If you want to force 'fdroid server' to use a non-standard serverwebroot
201
#
Daniel Martí's avatar
Daniel Martí committed
202
# nonstandardwebroot = False
203

204

205 206 207 208 209 210
# The build logs can be posted to a mediawiki instance, like on f-droid.org.
# wiki_protocol = "http"
# wiki_server = "server"
# wiki_path = "/wiki/"
# wiki_user = "login"
# wiki_password = "1234"
Ciaran Gultnieks's avatar
Ciaran Gultnieks committed
211

Daniel Martí's avatar
Daniel Martí committed
212 213 214
# Only set this to true when running a repository where you want to generate
# stats, and only then on the master build servers, not a development
# machine.
215
# update_stats = True
216

217 218
# When used with stats, this is a list of IP addresses that are ignored for
# calculation purposes.
219
# stats_ignore = []
220

221
# Server stats logs are retrieved from. Required when update_stats is True.
222
# stats_server = "example.com"
223 224

# User stats logs are retrieved from. Required when update_stats is True.
225
# stats_user = "bob"
226

Daniel Martí's avatar
Daniel Martí committed
227
# Use the following to push stats to a Carbon instance:
228 229 230
# stats_to_carbon = False
# carbon_host = '0.0.0.0'
# carbon_port = 2003
231

Daniel Martí's avatar
Daniel Martí committed
232 233
# Set this to true to always use a build server. This saves specifying the
# --server option on dedicated secure build server hosts.
234
# build_server_always = True
235

236
# By default, fdroid will use YAML and the custom .txt metadata formats. It
237 238 239
# is also possible to have metadata in JSON and XML by adding 'json' and
# 'xml'.
# accepted_formats = ['txt', 'yaml']
240

241 242
# Limit in number of characters that fields can take up
# Only the fields listed here are supported, defaults shown
243 244 245 246
# char_limits = {
#     'Summary': 80,
#     'Description': 4000,
# }