Installation Options

Simple installation

For a simple installation/upgrade of TinyPilot, see the instructions in the main README.

Advanced installation

Forcing installation

Simple installation restricts installation to only officially supported configurations of hardware and software.

If you'd like to try and install TinyPilot on different hardware or a different operating system, you can force installation by setting the FORCE_INSTALL environment variable before running the Simple installation commands:

export FORCE_INSTALL=1

Configuration options

To choose configuration options for the install, specify them in the /home/tinypilot/settings.yml file. These settings would persist on every update too.

Possible variables are available in:

• TinyPilot settings
• uStreamer settings
• nginx settings

Example: TC358743 HDMI to CSI capture chip

If you're using a Toshiba TC358743-based HDMI capture chip, the following installation options configure TinyPilot for that chip:

1. Add the TC358743 overlay option to your TinyPilot /boot/config.txt file:

if ! grep --silent '^dtoverlay=tc358743$' /boot/config.txt; then
  echo 'dtoverlay=tc358743' | sudo tee --append /boot/config.txt
fi

2. Run the get-tinypilot.sh script:

(sudo apt remove --yes tinypilot || true) && \
  curl \
    --silent \
    --show-error \
    https://raw.githubusercontent.com/tiny-pilot/tinypilot/master/get-tinypilot.sh | \
      bash - && \
  sudo reboot

Developer installation

If you're interested in contributing to TinyPilot, see the CONTRIBUTING file for instructions on setting up your development environment.

Use proxy

This procedures shows how to install TinyPilot using proxy.

1. get get-tinypilot.sh script.

sudo su
export http_proxy=http://<proxy server address>:<proxy port>/
# if you use proxy which requires login:
# export http_proxy=http://<user id>:<password>@<proxy server address>:<proxy port>/
export https_proxy=${http_proxy}
git config --global http.proxy ${http_proxy}
git config --global https.proxy ${https_proxy}
git config --global http.sslVerify false
wget --no-check-certificate https://raw.githubusercontent.com/tiny-pilot/tinypilot/master/get-tinypilot.sh

2. Edit get-tinypilot.sh and save as get-tinypilot-proxied.sh

sed -e 's/sudo apt-get/sudo -E apt-get/' get-tinypilot.sh > get-tinypilot-proxied.sh
sed -i -e 's/pip install/pip --trusted-host pypi.org --trusted-host files.pythonhosted.org install/' get-tinypilot-proxied.sh
sed -i -e "s/ansible-galaxy install/ansible-galaxy install --ignore-cert/" get-tinypilot-proxied.sh

3. Add the installation options to your TinyPilot settings.yml file:

TINYPILOT_SETTINGS="/home/tinypilot/settings.yml" && \
  sudo useradd --create-home --system --user-group tinypilot && \
  echo 'tinypilot_pip_args: "--trusted-host pypi.org --trusted-host files.pythonhosted.org"' | sudo tee -a "${TINYPILOT_SETTINGS}" && \
  sudo chown tinypilot:tinypilot "${TINYPILOT_SETTINGS}"

4. Run get-tinypilot-proxied.sh

get-tinypilot-proxied.sh && reboot