NAME

       geoclue.conf - geoclue configuration parameters

SYNOPSIS

       /etc/geoclue/geoclue.conf

DESCRIPTION

       The  geoclue  geoclue.conf  configuration  file  specifies  parameters  that  control  the
       operation of geoclue.

       All configurations settings below are mandatory and the defaults are what you  see  before
       you  edit  them  in  geoclue.conf. If you want to keep the default values around, copy and
       comment out the appropriate line(s) before changing them.

AGENT CONFIGURATION OPTIONS

       [agent] is used to begin the agent configuration.

       whitelist
              Whitelist of desktop IDs (without  .desktop  part)  of  all  agents  we  recognise,
              separated by a ';'.

              whitelist=geoclue-demo-agent;gnome-shell;io.elementary.desktop.agent-geoclue2

       [network-nmea]
              Network NMEA source configuration options

              enable=true
              Fetch location from NMEA sources on local network?

       [3G]
              3G source configuration options

              enable=true
              Enable 3G source

       [cdma]
              CDMA source configuration options

              enable=true
              Enable CDMA source

       [modem-gps]
              Modem GPS source configuration options

              enable=true
              Enable Modem-GPS source

       [wifi]
              WiFi source configuration options

              enable=true
              Enable WiFi source

              url=https://location.services.mozilla.com/v1/geolocate?key=geoclue
              URL  to  the wifi geolocation service. The key can currenty be anything, just needs
              to be present but that is likely going to change in future.

              submit-data=false Submit data to Mozilla Location Service
              If set to true, geoclue will automatically submit network data to Mozilla each time
              it gets a GPS lock.

              submission-url=https://location.services.mozilla.com/v1/submit?key=geoclue
              URL to submission API of Mozilla Location Service

              submission-nick=geoclue
              A nickname to submit network data with. A nickname must be 2-32 characters long.

APPLICATION CONFIGURATION OPTIONS

       Having  an entry here for an application with allowed=true means that geoclue will not ask
       agent to authorize the application. This is to  ensure  that  applications  with  built-in
       authorization mechanism (e.g web browsers) do not have to be bound to agents.

       If  your  application  is  denied access to location information and your operating system
       doesn't provide any mechanism to change that, it is likely a bug in your operation  system
       (or  geoclue).  The  solution  is to report the issue with all details, rather than adding
       your application to this list.

       Format:
              [random-app]
              Desktop ID of application without .desktop part

              allowed=true|false
              Allowed access to location information?

              system=true|false
              Is application a system component?

              users=
              List of UIDs of all users for which  this  application  is  allowed  location  info
              access, separate by ';'. Keep it empty for allowing it for all users.

       Examples:
              [gnome-datetime-panel]
              allowed=true
              system=true
              users=

              [gnome-color-panel]
              allowed=true
              system=true
              users=

              [org.gnome.Shell]
              allowed=true
              system=true
              users=

              [io.elementary.desktop.agent-geoclue2]
              allowed=true
              system=true
              users=

              [epiphany]
              allowed=true
              system=false
              users=

              [firefox]
              allowed=true
              system=false
              users=

AUTHOR

       Sachin Chand

                                                                         GEOCLUE CONFIGURATION(5)