Home

Jerusalem Science Museum — Kiosk Setup Wiki

This wiki explains how to set up and maintain the kiosk computers that run exhibits at the Jerusalem Science Museum.

Developing an Exhibit

Building software for a museum exhibit? See the Exhibit Development Guide — it covers repo setup, naming conventions, the required setup.sh and run.sh scripts, and how to test your code on a fresh kiosk install.

Setting Up a New Kiosk

Linux Mint (desktop PCs)

For standard kiosk computers running Linux Mint:

1. Installing Mint — Install Linux Mint on the computer
2. Kiosk Base Setup — Run the base setup script to install common software and configure kiosk behavior
3. Set up the exhibit — Clone the exhibit's GitHub repo and run its own setup.sh.

Raspberry Pi

For exhibits running on a Raspberry Pi:

1. Install Raspberry Pi OS on the Pi (using Raspberry Pi Imager)
2. Kiosk Base Setup RPi — Copy the appropriate setup script (GUI or terminal variant) into your project repo and run it. The page explains both variants and when to use each.

Other Resources

• Linux Utils and Useful Commands — Terminal commands for maintenance and troubleshooting
• Networking and Remote Access — How to connect to kiosks remotely using AnyDesk or SSH
• Contributors and Repositories — Who built what, and where the code lives

Quick Reference

• Remote access: All kiosks use AnyDesk — see Networking and Remote Access
• Exhibit code: GitHub organization
• Graphics for exhibits: Google Drive