Add Note to "Getting Started" page for Raspberry Pi 5 page size issue (#9888)

Add Note to "Getting Started" page for Raspberry Pi 5 page size issue
with `supabase-vector` that prevents `docker compose up` from running
successfully.

<!-- Clearly explain the need for these changes: -->

### Changes 🏗️

- Added a Note to the "Getting Started" page that explains a change in
Raspberry Pi OS for Raspberry Pi 5s, and how to revert the change to
avoid an issue running the backend on Docker.

<!-- Concisely describe all of the changes made in this pull request:
-->

### Checklist 📋

#### For code changes:
- [x] No code changes

#### For configuration changes:
- [x] No configuration changes

---------

Co-authored-by: Zamil Majdy <zamil.majdy@agpt.co>
Co-authored-by: Nicholas Tindle <nicholas.tindle@agpt.co>
This commit is contained in:
Japh
2025-04-29 05:07:44 +10:00
committed by GitHub
parent a1f17ca797
commit fb5ce0a16d

View File

@@ -57,6 +57,28 @@ docker compose -v
Once you have Docker and Docker Compose installed, you can proceed to the next step.
<details>
<summary>
Raspberry Pi 5 Specific Notes
</summary>
On Raspberry Pi 5 with Raspberry Pi OS, the default 16K page size will cause issues with the <code>supabase-vector</code> container (expected: 4K).
</br>
To fix this, edit <code>/boot/firmware/config.txt</code> and add:
</br>
```ini
kernel=kernel8.img
```
Then reboot. You can check your page size with:
</br>
```bash
getconf PAGESIZE
```
<code>16384</code> means 16K (incorrect), and <code>4096</code> means 4K (correct).
After adjusting, <code>docker compose up -d --build</code> should work normally.
</br>
See <a href="https://github.com/supabase/supabase/issues/33816">supabase/supabase #33816</a> for additional context.
</details>
## Setup
### Cloning the Repository