IIAB/local vars.yml: Difference between revisions
No edit summary |
No edit summary |
||
| (118 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 derived from Tim Moody's of February 24, 2017: (for [[../6.2|IIAB/XSCE 6.2]] on Raspberry Pi 3 especially!) |
|||
To understand how and why you may want to modify local_vars.yml (to override [https://github.com/XSCE/xsce/blob/release-6.2/vars/default_vars.yml default_vars.yml]) please read [https://github.com/XSCE/xsce/wiki/IIAB-Architecture IIAB Architecture]. |
|||
| ⚫ | |||
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]. |
|||
| ⚫ | |||
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 — 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 |
|||
# PLEASE READ http://wiki.laptop.org/go/XS_Community_Edition/local_vars.yml |
|||
# SEE EXAMPLE http://download.iiab.io/6.3/rpi/local_vars.yml |
|||
(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]]''') |
|||
# Original Idea: branch github.com/xsce/xsce-local [STALE] for your deployment |
|||
# xsce_admin_user: xsce-admin |
|||
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". |
|||
# 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" |
|||
dns_jail_enabled: False |
|||
squid_enabled: False |
|||
xsce_gateway_enabled: False |
|||
# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010) via server's WAN. See github.com/iiab/iiab/blob/master/roles/network/templates/gateway/xs-gen-iptables |
|||
services_externally_visible: True |
|||
# 4-server-options |
|||
authserver_install: False |
|||
authserver_enabled: False |
|||
openvpn_enabled: True |
|||
# The following seems necessary on CentOS: |
|||
# openvpn_cron_enabled: True |
|||
# If changing the above, remember to run "cd /opt/schoolserver/xsce; ./runtags openvpn" |
|||
# 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: False |
|||
ejabberd_install: False |
|||
ejabberd_enabled: False |
|||
idmgr_install: False |
|||
debian_schooltool_install: False |
|||
# 6-generic-aps |
|||
# 7-edu-aps |
|||
pathagar_install: False |
|||
# Change calibre_port to 8010 if you're using XO laptops needing idmgr ! |
|||
calibre_port: 8080 |
|||
# 8-mgmt-tools |
|||
sugar_stats_install: False |
|||
ajenti_install: False |
|||
monit_install: True |
|||
monit_enabled: False |
|||
xovis_install: False |
|||
teamviewer_install: False |
|||
activity_server_enabled: False |
|||
</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".