# Raspberry Pi deployment

This app can run directly on a Raspberry Pi with **nginx + php-fpm** instead of Docker.

## What the script does

`scripts/deploy-raspi.sh` runs from your local machine and connects over SSH to the Pi. On the Pi it will:

- install `nginx`, `git`, `composer`, and PHP 8.2 packages
- clone or update the repository
- create/update `.env`
- install Composer dependencies
- prepare the default SQLite database
- run migrations
- create an nginx vhost that serves `public/`
- create a `systemd` service for `php command.php queue:work`

## Assumptions

- the Raspberry Pi is running a Debian/Raspberry Pi OS style distro with `apt`
- your SSH user can run `sudo`
- the repository is reachable from the Pi over Git/SSH or HTTPS
- you want the app at `/var/www/warehouse`
- you are fine using the app's default **SQLite** setup

## Basic usage

From this repo on your local machine:

```bash
chmod +x scripts/deploy-raspi.sh
scripts/deploy-raspi.sh pi@raspberrypi.local git@github.com:YOUR_USER/warehouse.git DietPi.ntp.kentcommunications.com
```

Arguments:

- argument 1: SSH target, for example `pi@192.168.1.50`
- argument 2: Git clone URL the Pi can access
- argument 3: nginx `server_name` value, optional, defaults to `DietPi.ntp.kentcommunications.com`

## Useful environment overrides

```bash
DEPLOY_REF=main \
DEPLOY_PATH=/var/www/warehouse \
PHP_VERSION=8.2 \
scripts/deploy-raspi.sh pi@raspberrypi.local git@github.com:YOUR_USER/warehouse.git DietPi.ntp.kentcommunications.com
```

## After deploy

- browse to `http://DietPi.ntp.kentcommunications.com`
- check nginx with `sudo systemctl status nginx`
- check php-fpm with `sudo systemctl status php8.2-fpm`
- check the queue worker with `sudo systemctl status warehouse-queue.service`

## Notes

- the app serves from `public/`, so the nginx root must stay pointed there
- low-stock emails are always queued in this app, so the queue worker service matters in production
- this script sets up **HTTP only**; add TLS separately with `certbot` or another reverse-proxy setup if you want HTTPS
- if you prefer MySQL instead of SQLite, update `.env` and the script before rerunning it