IIAB/local vars.yml: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
 
(136 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{xsce}}
{{xsce}}
BELOW is an EXAMPLE /opt/schoolserver/xsce/vars/local_vars.yml originally from Tim Moody: (for [[../6.2|XSCE/IIAB 6.2]] on Raspberry Pi 3, originally from February 24, 2017)


To understand how and why you may want to modify local_vars.yml, please read [https://github.com/XSCE/xsce/wiki/IIAB-Architecture IIAB Architecture].


Please also see [http://faq.iiab.io FAQ.IIAB.IO], specifically: '''[[../FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F|"What is local_vars.yml and how do I customize it?"]]'''
Please also ask directly on our support channels, like http://iiab.io forums, the [http://lists.laptop.org/listinfo/server-devel server-devel] mailing list, and [https://webchat.freenode.net/?channels=#schoolserver live irc chat].


Or return to our Internet-in-a-Box (IIAB/XSCE) [[../FAQ|Frequently Asked Questions]], within question [[../FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F|"What is local_vars.yml and how do I customize it?"]]


Here is an example MEDIUM-sized <code>/etc/iiab/local_vars.yml</code> including a suite of about a dozen Internet-in-a-Box (IIAB) server apps &mdash; that have been well-tested on Raspberry Pi 3 and similar computers: '''https://github.com/iiab/iiab/blob/master/vars/local_vars_medium.yml'''
<pre># Put variables for your installation that override defaults here
# Better still, put this file in a branch of https://github.com/XSCE/xsce-local for your deployment


#xsce_admin_user: xsce-admin


(Compare: MIN-sized with [[../local_vars_min.yml|local_vars_min.yml]] with ~6 apps, and BIG-sized with [[../local_vars_big.yml|local_vars_big.yml]] ~20 apps ...using our '''[[../FAQ#What_services_.28IIAB_apps.29_are_suggested_during_installation.3F|new comparison table]]''')
# obtain a password hash with - python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")'
#xsce_admin_passw_hash:


xsce_hostname: box
xsce_home_url: /home
host_ssid: "Internet in a Box"
hostapd_secure: False
hostapd_password: "MYPASSWORD"
xsce_gateway_enabled: False
dns_jail_enabled: False
services_externally_visible: True
squid_enabled: False


WARNING: on small Internet-in-a-Box devices, it's common to want a [[IIAB/FAQ#Is_a_.22Rapid_Power_Off.22_button_possible_for_low-electricity_environments.3F|"Rapid Power Off" button]] clickable by '''''all''''' users in a clinic or home. Conversely, schoolteachers commonly want to disable this Power Off button, changing the "allow_apache_sudo" flag to "False".
# 4-server-options
authserver_install: False
authserver_enabled: False

# Josh Dennis recommends the following 2 lines, as CUPS printing seems to cause errors on many Linux distributions:
cups_install: False
cups_enable: False

# 5-xoservices
xo_services_install: True
ejabberd_install: False
ejabberd_enabled: False
idmgr_install: False
debian_schooltool_install: False

# 6-generic-aps

# 7-edu-aps
pathagar_install: True

# 8-mgmat-tools
sugar_stats_install: False
ajenti_install: False
monit_install: True
xovis_install: False
teamviewer_install: False
activity_server_enabled: True
</pre>

Latest revision as of 18:03, 22 April 2019

This IIAB XSCE content does not reflect the opinion of OLPC. These pages were created by members of a volunteer community supporting OLPC and deployments.


Please also see FAQ.IIAB.IO, specifically: "What is local_vars.yml and how do I customize it?"


Here is an example MEDIUM-sized /etc/iiab/local_vars.yml including a suite of about a dozen Internet-in-a-Box (IIAB) server apps — that have been well-tested on Raspberry Pi 3 and similar computers: https://github.com/iiab/iiab/blob/master/vars/local_vars_medium.yml


(Compare: MIN-sized with local_vars_min.yml with ~6 apps, and BIG-sized with local_vars_big.yml ~20 apps ...using our new comparison table)


WARNING: on small Internet-in-a-Box devices, it's common to want a "Rapid Power Off" button clickable by all users in a clinic or home. Conversely, schoolteachers commonly want to disable this Power Off button, changing the "allow_apache_sudo" flag to "False".