IIAB/local vars min.yml: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
No edit summary
 
(56 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 very quickly/compactly (installs only a few 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?"]]'''
WARNING: on such very small Internet-in-a-Box devices, the "Rapid Power Off" button can be clicked by '''''all''''' users! Change the "allow_apache_sudo" flag below to "False" and read more about this [[FAQ#Is_a_.22Rapid_Power_Off.22_button_possible_for_low-electricity_environments.3F|in our FAQ]] if you are a teacher who wants to disable this Power Off button.


COMPARE the original: [[../local_vars.yml|local_vars.yml]]


Here is an example MIN-sized <code>/etc/iiab/local_vars.yml</code> including a very basic suite of a half-dozen Internet-in-a-Box (IIAB) server apps &mdash; to enable a rapid and compact install, e.g. on Raspberry Pi 3 and similar computers: '''https://github.com/iiab/iiab/blob/master/vars/local_vars_min.yml'''
<pre>
# Put variables for your installation that override defaults here


# 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


(Compare: MEDIUM-sized [[../local_vars.yml|local_vars.yml]] with ~12 apps, and BIG-sized [[../local_vars_big.yml|local_vars_big.yml]] with ~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 for your deployment


# iiab_admin_user: iiab-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>")'
# iiab_admin_passw_hash:

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 False to disable http://box/common/services/power_off.php button:
allow_apache_sudo: True

# 3-BASE

squid_install: False
squid_enabled: False

dansguardian_install: False
dansguardian_enabled: False

# wondershaper_install: False
# wondershaper_enabled: False

# 4-SERVER-OPTIONS

authserver_install: False
authserver_enabled: False

# 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"

# samba_install: False
# samba_enabled: False

# WARNING: Josh Dennis [April 2017] warned that CUPS printing can block Ansible
cups_install: True
cups_enabled: False

# 5-XO-SERVICES

# The 4 below are no longer actively supported.
# Please contact http://lists.laptop.org/pipermail/server-devel/ if you can help!

# Change calibre_port from 8080 to 8010 below, if you enable idmgr

# activity_server_install: False
# activity_server_enabled: False

# idmgr_install: False
# idmgr_enabled: False

# ejabberd_install: False
# ejabberd_enabled: False

# xo_services_install: False
# xo_services_enabled: False

# 6-GENERIC-APPS

elgg_install: False
elgg_enabled: False

nextcloud_install: False
nextcloud_enabled: False

wordpress_install: False
wordpress_enabled: False

# phpmyadmin_install: False
# phpmyadmin_enabled: False

# dokuwiki_install: False
# dokuwiki_enabled: False

# 7-EDU-APPS

# OpenStreetMap: renamed from {iiab_install, iiab_enabled} in June 2017
osm_install: False
osm_enabled: False

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: False
sugarizer_enabled: False

calibre_install: False
calibre_enabled: False
# Change calibre_port to 8010 if you're using XO laptops needing above idmgr
calibre_port: 8080

# Change to True if you have disk space & don't mind Ansible's ~15 min delay
moodle_install: False
moodle_enabled: False

# pathagar_install: False
# pathagar_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

ajenti_install: False
ajenti_enabled: False

# schooltool_install: False
# schooltool_enabled: False

# debian_schooltool_install: False
# debian_schooltool_enabled: False

# sugar_stats_install: False
# sugar_stats_enabled: False

# xovis_install: False
# xovis_enabled: False
</pre>

Latest revision as of 18:04, 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 MIN-sized /etc/iiab/local_vars.yml including a very basic suite of a half-dozen Internet-in-a-Box (IIAB) server apps — to enable a rapid and compact install, e.g. on Raspberry Pi 3 and similar computers: https://github.com/iiab/iiab/blob/master/vars/local_vars_min.yml


(Compare: MEDIUM-sized local_vars.yml with ~12 apps, and BIG-sized local_vars_big.yml with ~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".

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=IIAB/local_vars_min.yml&oldid=301827"