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