chiark / gitweb /
Merge branch 'update-vagrantfile' into 'master'
[fdroidserver.git] / examples / config.py
1 #!/usr/bin/env python2
2
3 # Copy this file to config.py, then amend the settings below according to
4 # your system configuration.
5
6 # Override the path to the Android SDK, $ANDROID_HOME by default
7 # sdk_path = "/path/to/android-sdk"
8
9 # Override the path to the Android NDK, $ANDROID_NDK by default
10 # ndk_path = "/path/to/android-ndk"
11 # Build tools version to be used
12 build_tools = "21.0.2"
13
14 # Command for running Ant
15 # ant = "/path/to/ant"
16 ant = "ant"
17
18 # Command for running maven 3
19 # mvn3 = "/path/to/mvn"
20 mvn3 = "mvn"
21
22 # Command for running Gradle
23 # gradle = "/path/to/gradle"
24 gradle = "gradle"
25
26 # Set the maximum age (in days) of an index that a client should accept from
27 # this repo. Setting it to 0 or not setting it at all disables this
28 # functionality. If you do set this to a non-zero value, you need to ensure
29 # that your index is updated much more frequently than the specified interval.
30 # The same policy is applied to the archive repo, if there is one.
31 repo_maxage = 0
32
33 repo_url = "https://MyFirstFDroidRepo.org/fdroid/repo"
34 repo_name = "My First FDroid Repo Demo"
35 repo_icon = "fdroid-icon.png"
36 repo_description = """
37 This is a repository of apps to be used with FDroid. Applications in this
38 repository are either official binaries built by the original application
39 developers, or are binaries built from source by the admin of f-droid.org
40 using the tools on https://gitlab.com/u/fdroid.
41 """
42
43 # As above, but for the archive repo.
44 # archive_older sets the number of versions kept in the main repo, with all
45 # older ones going to the archive. Set it to 0, and there will be no archive
46 # repository, and no need to define the other archive_ values.
47 archive_older = 3
48 archive_url = "https://f-droid.org/archive"
49 archive_name = "My First FDroid Archive Demo"
50 archive_icon = "fdroid-icon.png"
51 archive_description = """
52 The repository of older versions of applications from the main demo repository.
53 """
54
55
56 # The ID of a GPG key for making detached signatures for apks. Optional.
57 # gpgkey = '1DBA2E89'
58
59 # The key (from the keystore defined below) to be used for signing the
60 # repository itself.  This is the same name you would give to keytool or
61 # jarsigner using -alias.  (Not needed in an unsigned repository).
62 # repo_keyalias = "fdroidrepo"
63
64 # The keystore to use for release keys when building. This needs to be
65 # somewhere safe and secure, and backed up!  The best way to manage these
66 # sensitive keys is to use a "smartcard" (aka Hardware Security Module). To
67 # configure FDroid to use a smartcard, set the keystore file using the keyword
68 # "NONE" (i.e. keystore = "NONE").  That makes Java find the keystore on the
69 # smartcard based on 'smartcardoptions' below.
70 # keystore = "~/.local/share/fdroidserver/keystore.jks"
71
72 # You should not need to change these at all, unless you have a very
73 # customized setup for using smartcards in Java with keytool/jarsigner
74 # smartcardoptions = "-storetype PKCS11 -providerName SunPKCS11-OpenSC \
75 #    -providerClass sun.security.pkcs11.SunPKCS11 \
76 #    -providerArg opensc-fdroid.cfg"
77
78 # The password for the keystore (at least 6 characters).  If this password is
79 # different than the keypass below, it can be OK to store the password in this
80 # file for real use.  But in general, sensitive passwords should not be stored
81 # in text files!
82 # keystorepass = "password1"
83
84 # The password for keys - the same is used for each auto-generated key as well
85 # as for the repository key.  You should not normally store this password in a
86 # file since it is a sensitive password.
87 # keypass = "password2"
88
89 # The distinguished name used for all keys.
90 keydname = "CN=Birdman, OU=Cell, O=Alcatraz, L=Alcatraz, S=California, C=US"
91
92 # Use this to override the auto-generated key aliases with specific ones
93 # for particular applications. Normally, just leave it empty.
94 keyaliases = {}
95 keyaliases['com.example.app'] = 'example'
96 # You can also force an app to use the same key alias as another one, using
97 # the @ prefix.
98 keyaliases['com.example.another.plugin'] = '@com.example.another'
99
100
101 # The full path to the root of the repository.  It must be specified in
102 # rsync/ssh format for a remote host/path. This is used for syncing a locally
103 # generated repo to the server that is it hosted on.  It must end in the
104 # standard public repo name of "/fdroid", but can be in up to three levels of
105 # sub-directories (i.e. /var/www/packagerepos/fdroid).  You can include
106 # multiple servers to sync to by wrapping the whole thing in {} or [], and
107 # including the serverwebroot strings in a comma-separated list.
108 #
109 # serverwebroot = 'user@example:/var/www/fdroid'
110 # serverwebroot = {
111 #     'foo.com:/usr/share/nginx/www/fdroid',
112 #     'bar.info:/var/www/fdroid',
113 #     }
114
115
116 # optionally specific which identity file to use when using rsync over SSH
117 #
118 # identity_file = '~/.ssh/fdroid_id_rsa'
119
120
121 # If you are running the repo signing process on a completely offline machine,
122 # which provides the best security, then you can specify a folder to sync the
123 # repo to when running `fdroid server update`.  This is most likely going to
124 # be a USB thumb drive, SD Card, or some other kind of removable media.  Make
125 # sure it is mounted before running `fdroid server update`.  Using the
126 # standard folder called 'fdroid' as the specified folder is recommended, like
127 # with serverwebroot.
128 #
129 # local_copy_dir = '/media/MyUSBThumbDrive/fdroid'
130
131
132 # If you are using local_copy_dir on an offline build/signing server, once the
133 # thumb drive has been plugged into the online machine, it will need to be
134 # synced to the copy on the online machine.  To make that happen
135 # automatically, set sync_from_local_copy_dir to True:
136 #
137 # sync_from_local_copy_dir = True
138
139
140 # To upload the repo to an Amazon S3 bucket using `fdroid server update`.
141 # Warning, this deletes and recreates the whole fdroid/ directory each
142 # time. This is based on apache-libcloud, which supports basically all cloud
143 # storage services, so it should be easy to port the fdroid server tools to
144 # any of them.
145 #
146 # awsbucket = 'myawsfdroid'
147 # awsaccesskeyid = 'SEE0CHAITHEIMAUR2USA'
148 # awssecretkey = 'yourverysecretkeywordpassphraserighthere'
149
150
151 # If you want to force 'fdroid server' to use a non-standard serverwebroot
152 #
153 # nonstandardwebroot = False
154
155
156 # Wiki details
157 wiki_protocol = "http"
158 wiki_server = "server"
159 wiki_path = "/wiki/"
160 wiki_user = "login"
161 wiki_password = "1234"
162
163 # Only set this to true when running a repository where you want to generate
164 # stats, and only then on the master build servers, not a development
165 # machine.
166 update_stats = False
167
168 # When used with stats, this is a list of IP addresses that are ignored for
169 # calculation purposes.
170 stats_ignore = []
171
172 # Server stats logs are retrieved from. Required when update_stats is True.
173 stats_server = "example.com"
174
175 # User stats logs are retrieved from. Required when update_stats is True.
176 stats_user = "bob"
177
178 # Use the following to push stats to a Carbon instance:
179 stats_to_carbon = False
180 carbon_host = '0.0.0.0'
181 carbon_port = 2003
182
183 # Set this to true to always use a build server. This saves specifying the
184 # --server option on dedicated secure build server hosts.
185 build_server_always = False
186
187 # Limit in number of characters that fields can take up
188 # Only the fields listed here are supported, defaults shown
189 char_limits = {
190     'Summary': 50,
191     'Description': 1500
192 }