# sample KioskCD customization file, for use with the kcd-customizer tool # v2.8 Nov 2005 # # REQUIRED means that it must be set to something! # (this does not apply to an imported external file, which can be minimal) # # format is a simple assignment: kcd_something=string, quotes not needed # # to make the optional external file: # just copy the local one, edit, and upload to the server # # note: null values in external file will set local values to null # so either set/reset everything you want, or comment out what you # don't want to reset # # In v2.6, the external file that you put on the server must be in Unix format # (lines ending in \n, not \r\n). This was improved in v2.7, so # the format doesn't matter for v2.7 KioskCDs. # # 1 if the PC has Internet access # 0 for intranet # default = 0 # this means the DNS test will either use google (1) or your start page (0) # also, with setting of 1, a time sync is done with pool.ntp.org kcd_internet=1 # skip the ntp time check at boot, if this is causing problems # you want this check normally, esp. if the PC's battery is weak (or dead) # correct time allows cookies to work properly, among other benefits # default = 0 kcd_skip_timeset= # full URL of optional config page # settings from this page override local config settings # eg. kcd_ext_conf_url=http://kioskcd.com/adm/default.conf # default is null kcd_ext_conf_url= # select a network interface, eth0, eth1, tr0, etc. # eg. kcd_nic=eth1 # default is to try all available NICs # Note: this setting cannot be imported from an external config file kcd_nic= # optional custom name servers -- use IP addresses # eg. kcd_ns1=192.168.2.1 # default is to try DHCP-supplied name servers, then public name servers # if kcd_ns1=files, then ALL DNS checks are skipped, and /etc/hosts is used kcd_ns1= kcd_ns2= # 1 = skip the DNS check at boot, if this is causing problems # and you know that DNS works # default = 0 # Note: this setting cannot be imported from an external config file kcd_skip_dnstest= # optional fixed IP address # default is to get IP addrs from DHCP # IMPORTANT: for this option to work, # ipaddr, netmask, gateway must ALL be specified # AND you must specify a NIC above (kcd_nic) AND # at least one name server (kcd_ns1) # Note: this setting cannot be imported from an external config file kcd_ipaddr= kcd_netmask= # eg. if your fixed IP is 192.168.2.22, your gateway might be 192.168.2.1 kcd_gateway= # full URL of optional /etc/hosts file # eg. kcd_ext_hosts_url=http://kioskcd.com/adm/hosts.kioskcd # hosts file must be in the usual /etc/hosts format, DOS format (\r\n) okay # if this option is used, the DNS resolver is turned off, so only hosts # in the /etc/hosts file will be resolved # default is null kcd_ext_hosts_url= # optional /etc/hosts file entries # these lines are added to /etc/hosts # if ANY are used, the DNS resolver is turned off, so only hosts # in the /etc/hosts file will be resolved # these are added after any optional remote hosts file is imported # numbers go from 1 to 20, missing numbers are okay # must be in the usual /etc/hosts format, eg. "68.33.99.2 blah.domain.com" # you can disallow a certain domain with "0.0.0.0 bad.domain.com" kcd_hosts_entry[1]= kcd_hosts_entry[2]= kcd_hosts_entry[3]= kcd_hosts_entry[4]= kcd_hosts_entry[5]= # etc. up to 20 # optional idle timeout # after this many minutes, if no new cache files are found, all browsers # are killed and one restarts # default is 0 = none kcd_idle_restart= # optional keyboard layout (see keyboards file) # eg. kcd_keytable=fr # default = us # you can also override this at the boot prompt, such as: # Boot: vmlinuz keyboard=de # Note: this setting cannot be imported from an external config file kcd_keytable= # REQUIRED video settings # the final number is the color depth, some vidcards can't do # 1024x768x24, for example, only 1024x768x8, which is horrid # you might try 15 or 16 # 800x600x24 seems to work on anything, but fonts are fuzzy on flat-panels kcd_rez=800x600x24 # REQUIRED size and upper-left corner position of web browser window # doesn't always do what you think # (0, 0) is upper-left # second and third windows will cascade to left or right, depending # Note: X and Y don't do much, as the window manager does the positioning # as it sees fit. Also, a bug in a config script on the CD reverses X and Y # so that the X,Y settings below become Y,X. kcd_width=780 kcd_height=560 kcd_screenX=-5 kcd_screenY=55 # 1 means use client-side Java, 0 means turn it off # if Java is not installed, then this has no effect -- duh! kcd_java=1 # REQUIRED specify ps2, usb, or serial # or use the full device name of the mouse, like kcd_mouse=/dev/funmouse,3 kcd_mouse=ps2 # 0 means direct, 1 means use proxy # default is 0 kcd_useproxy=0 # hostname or IP address, and port for http and https proxies # default for hosts is null, for ports is zero kcd_proxyhost= kcd_proxyport= kcd_proxy_ssl_host= kcd_proxy_ssl_port= # if kcd_useproxy=1, then you specify a list of hosts/domains/IPs # that should not be proxied # domains and subdomains should begin with a dot # see http://www.mozilla.org/quality/networking/docs/aboutno_proxy_for.html # for more details on this setting # default is null # example: kcd_noproxies_on=nozo.stateu.edu, .intranet.abc.com kcd_no_proxies_on= # optional "home" page URL for the browser # else browser starts up with a blank page kcd_startpage=http://google.com # screensaver turns on after this many minutes idle # there are only two screensavers: the bouncing X and screenblank # 0 means no screensaver # default is 0 kcd_screensaver_after=0 # 1 blanks the screen, 0 you get bouncing X # default is 0 kcd_screensaver_blank=1 # 1 displays the URL bar (for entering URLs), 0 turns it off # default is 1 kcd_urlbar= # 1 displays the search box (next to URL bar), 0 turns it off # default is 1 kcd_search= # load the toolbar link buttons with these, # numbers go from 1 to 9, missing numbers are okay # format is button-label=URL kcd_link[1]=Yahoo Mail=http://mail.yahoo.com kcd_link[2]=Hotmail=http://www.hotmail.com kcd_link[3]=Google Mail=http://www.gmail.com kcd_link[4]=Adelphia=http://www.adelphiapowerpage.com/index.cfm kcd_link[5]=Comcast=http://www.comcast.net kcd_link[6]=Google Search=http://www.google.com kcd_link[7]=SBC/Prodigy=http://myhome.prodigy.net kcd_link[8]=Verizon=http://netmail.verizon.net kcd_link[9]=AOL=http://www.aol.com