Skip to content

Global prefs override.xml

David Anderson edited this page Jun 15, 2024 · 3 revisions

Preferences override file

Preferences and host venue are maintained on a project server, edited via a web interface, and downloaded from the server. You can also set preferences locally (on a particular computer) in BOINC's Advanced View by clicking Advanced -> Preferences.

Local preferences are stored in a 'preferences override file'. This file is read by the core client after it reads the preferences from the server, and it overrides those preferences. You can modify the preferences override file directly (in a text editor) if you like (for example, if you do not have the BOINC Manager installed).

After editing the preferences file, go to the Advanced View in BOINC manager and click ''Advanced -> Read local prefs file'' to make your new preferences take effect. If you do not have BOINC manager installed, restart the client or do ''boinccmd --read_global_prefs_override'' from a command line to have your new preferences take effect.

The preferences override file is named global_prefs_override.xml and it is located in the BOINC data directory.
Its structure is as follows:

<global_preferences>
<confirm_before_connecting/>
<cpu_scheduling_period_minutes>%f</cpu_scheduling_period_minutes>
<cpu_usage_limit>%f</cpu_usage_limit>
<day_prefs>
<day_of_week>%d</day_of_week>
<start_hour>%.02f</start_hour>
<end_hour>%.02f</end_hour>
<net_start_hour>%.02f</net_start_hour>
<net_end_hour>%.02f</net_end_hour>
</day_prefs>
<disk_interval>%f</disk_interval>
<disk_max_used_gb>%f</disk_max_used_gb>
<disk_max_used_pct>%f</disk_max_used_pct>
<disk_min_free_gb>%f</disk_min_free_gb>
<dont_verify_images/>
<end_hour>%f</end_hour>
<hangup_if_dialed/>
<host_venue>X</host_venue>
<idle_time_to_run>%f</idle_time_to_run>
<leave_apps_in_memory/>
<max_bytes_sec_down>%f</max_bytes_sec_down>
<max_bytes_sec_up>%f</max_bytes_sec_up>
<max_cpus>%d</max_cpus>
<net_end_hour>%f</net_end_hour>
<net_start_hour>%f</net_start_hour>
<ram_max_used_busy_pct>%f</ram_max_used_busy_pct>
<ram_max_used_idle_pct>%f</ram_max_used_idle_pct>
<run_if_user_active/>
<run_on_batteries/>
<start_hour>%f</start_hour>
<suspend_cpu_usage>%f</suspend_cpu_usage>
<suspend_if_no_recent_input>%f</suspend_if_no_recent_input>
<vm_max_used_pct>%f</vm_max_used_pct>
<work_buf_min_days>%f</work_buf_min_days>
<work_buf_additional_days>%f</work_buf_additional_days>
</global_preferences>
Clone this wiki locally