IIAB/local vars big.yml: Difference between revisions
No edit summary |
No edit summary |
||
(50 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{xsce}} |
{{xsce}} |
||
Below is an EXAMPLE /opt/iiab/iiab/vars/local_vars.yml towards installing more quickly/compactly (installs only ~10 server apps) for Raspberry Pi especially. |
|||
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?"]]''' |
|||
COMPARE: [[../local_vars.yml|local_vars.yml]] and [[../local_vars_min.yml|local_vars_min.yml]] |
|||
<pre> |
|||
# Put variables here to override /opt/iiab/iiab/vars/default_vars.yml |
|||
Here is an example BIG-sized <code>/etc/iiab/local_vars.yml</code> including a full suite of almost 20 Internet-in-a-Box (IIAB) server apps — to help implementers explore and remix different LMS choices and educational apps: '''https://github.com/iiab/iiab/blob/master/vars/local_vars_big.yml''' |
|||
# PLEASE READ http://wiki.laptop.org/go/IIAB/local_vars.yml |
|||
# SEE EXAMPLE http://download.iiab.io/6.4/rpi/local_vars_lite.yml |
|||
# SEE EXAMPLE http://download.iiab.io/6.4/rpi/local_vars_min.yml |
|||
# Original Idea: branch github.com/xsce/xsce-local for your deployment |
|||
(Compare: MIN-sized [[../local_vars_min.yml|local_vars_min.yml]] with ~6 apps, and MEDIUM-sized [[../local_vars.yml|local_vars.yml]] with ~12 apps ...using our '''[[../FAQ#What_services_.28IIAB_apps.29_are_suggested_during_installation.3F|new comparison table]]''') |
|||
iiab_admin_user: iiab-admin |
|||
# Obtain a password hash with: python -c 'import crypt; print crypt.crypt("<plaintext>", "$6$<salt>")' |
|||
# iiab_admin_passw_hash: |
|||
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". |
|||
iiab_hostname: box |
|||
iiab_domain: lan |
|||
iiab_home_url: /home |
|||
host_ssid: "Internet in a Box" |
|||
host_wifi_mode: g |
|||
host_channel: 6 |
|||
hostapd_secure: False |
|||
hostapd_password: changeme |
|||
dns_jail_enabled: False |
|||
# Enables "campus access" to kiwix (3000), kalite (8008) & calibre (8010 or |
|||
# 8080) on WAN side of server. See network/templates/gateway/iiab-gen-iptables |
|||
# within github.com/iiab/iiab/blob/master/roles/ |
|||
services_externally_visible: True |
|||
# Make this True if client machines should have access to WAN/Internet: |
|||
iiab_gateway_enabled: False |
|||
# Make this True if you want http://box/common/services/power_off.php to work: |
|||
allow_apache_sudo: False |
|||
# 3-BASE |
|||
squid_install: False |
|||
squid_enabled: False |
|||
dansguardian_install: False |
|||
dansguardian_enabled: False |
|||
wondershaper_install: False |
|||
wondershaper_enabled: False |
|||
# 4-SERVER-OPTIONS |
|||
# SECURITY WARNING: See http://wiki.laptop.org/go/IIAB/Security |
|||
openvpn_install: True |
|||
openvpn_enabled: False |
|||
# The following seems necessary on CentOS: |
|||
# openvpn_cron_enabled: True |
|||
# If changing the above, remember to run "cd /opt/iiab/iiab; ./runtags openvpn" |
|||
# WARNING: Josh Dennis [April 2017] warned that CUPS printing can block Ansible |
|||
cups_install: True |
|||
cups_enabled: False |
|||
# At Your Own Risk: take a security audit seriously before deploying this |
|||
samba_install: False |
|||
samba_enabled: False |
|||
# Handy for maintaining tables, but DANGEROUS if not locked down |
|||
phpmyadmin_install: False |
|||
phpmyadmin_enabled: False |
|||
# 5-XO-SERVICES |
|||
# Legacy XO services have been removed but are recoverable. Please contact |
|||
# http://lists.laptop.org/pipermail/server-devel/ if you're able to help test. |
|||
# authserver_install: False |
|||
# authserver_enabled: False |
|||
# activity_server_install: False |
|||
# activity_server_enabled: False |
|||
# Change calibre_port from 8080 to 8010 below, if you enable idmgr |
|||
# idmgr_install: False |
|||
# idmgr_enabled: False |
|||
# ejabberd_install: False |
|||
# ejabberd_enabled: False |
|||
# xo_services_install: False |
|||
# xo_services_enabled: False |
|||
# sugar_stats_install: False |
|||
# sugar_stats_enabled: False |
|||
# xovis_install: False |
|||
# xovis_enabled: False |
|||
# 6-GENERIC-APPS |
|||
nextcloud_install: True |
|||
nextcloud_enabled: True |
|||
wordpress_install: True |
|||
wordpress_enabled: True |
|||
elgg_install: True |
|||
elgg_enabled: False |
|||
dokuwiki_install: False |
|||
dokuwiki_enabled: False |
|||
# 7-EDU-APPS |
|||
# OpenStreetMap: renamed from {iiab_install, iiab_enabled} in June 2017 |
|||
osm_install: True |
|||
osm_enabled: True |
|||
kiwix_serve_install: True |
|||
kiwix_serve_enabled: True |
|||
kalite_install: True |
|||
kalite_enabled: True |
|||
kalite_cron_enabled: True |
|||
# Might stall MongoDB on Power Failure: github.com/xsce/xsce/issues/879 |
|||
sugarizer_install: True |
|||
sugarizer_enabled: True |
|||
calibre_install: True |
|||
calibre_enabled: True |
|||
# Change calibre_port to 8010 if you're using XO laptops needing above idmgr |
|||
calibre_port: 8080 |
|||
# Similar to Calibre, but unmaintained |
|||
pathagar_install: False |
|||
pathagar_enabled: False |
|||
# Change to True if you have disk space & don't mind Ansible's ~15 min delay |
|||
moodle_install: False |
|||
moodle_enabled: False |
|||
# 8-MGMT-TOOLS |
|||
munin_install: True |
|||
munin_enabled: True |
|||
vnstat_install: True |
|||
vnstat_enabled: True |
|||
awstats_install: True |
|||
awstats_enabled: True |
|||
monit_install: False |
|||
monit_enabled: False |
|||
schooltool_install: False |
|||
schooltool_enabled: False |
|||
debian_schooltool_install: False |
|||
debian_schooltool_enabled: False |
|||
</pre> |
Latest revision as of 18:05, 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 BIG-sized /etc/iiab/local_vars.yml
including a full suite of almost 20 Internet-in-a-Box (IIAB) server apps — to help implementers explore and remix different LMS choices and educational apps: https://github.com/iiab/iiab/blob/master/vars/local_vars_big.yml
(Compare: MIN-sized local_vars_min.yml with ~6 apps, and MEDIUM-sized local_vars.yml with ~12 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".