54 lines
2.5 KiB
Markdown
54 lines
2.5 KiB
Markdown
# Raspberry Pi, Linux, and Coding Introduction
|
|
A guide to the fundamentals of the Raspberry Pi through the exploration of coding, networking, and Linux. See the full guide at [vintagecoding.net](https://raspi.vintagecoding.net), or follow **Getting Started** to host a mirror of the manual directly on your Raspberry Pi.
|
|
|
|
The possibilities are endless, and support for more projects is coming soon!
|
|
|
|
## Getting Started
|
|
Run the commands below in the terminal application on a fresh installation on a Raspberry Pi. To paste into a terminal, use Control+Shift+v. If you need help with installing the Operating System (OS) on your Pi, please see the [manual](https://raspi.vintagecoding.net#install-os).
|
|
|
|
```bash
|
|
sudo apt install git;
|
|
git clone https://github.com/SLCPL-CreativeLab/ras-pi;
|
|
cd ras-pi/scripts;
|
|
./setup.sh;
|
|
|
|
# Optionally:
|
|
./setup-ai.sh # Installs Ollama (all supported Pi's) and Open WebUI (only on Pi 5 and higher).
|
|
./setup-manual.sh # Installs the manual.
|
|
./setup-jellyfin.sh # Installs Jellyfin.
|
|
```
|
|
|
|
## Expose Services to the Internet
|
|
To use `cloudflared` to expose services to the internet, you must:
|
|
|
|
- Make a Cloudflare account & purchase a domain
|
|
- Run the command `cloudflared tunnel login`
|
|
- Run the command `./setup-cloudflared.sh` in ~/ras-pi/scripts
|
|
|
|
or:
|
|
|
|
- `cloudflared tunnel --url=http://localhost:PORT`
|
|
|
|
to alternatively temporarily expose a single service to the internet. PORT is the service you'd like to expose. The ports used with the standard services are below.
|
|
|
|
| PORT | SERVICE |
|
|
|--------------------|----------------------------------------------|
|
|
| 5090 | Mirror of raspi.vintagecoding.net |
|
|
| 5091 | Jellyfin |
|
|
| 5092 | Open WebUI |
|
|
|
|
For more information about `cloudflared`, particularly regarding the security of connecting a service to the internet, please read their [docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/).
|
|
|
|
## Contributions & Support
|
|
Feel free to contribute to the project! Please see **CONTRIBUTIONS.md** to start.
|
|
|
|
If you need any help with getting started, please email [me](mailto:jashton@slcpl.org).
|
|
|
|
## Projects/Software Used
|
|
|
|
- [ollama](https://github.com/ollama/ollama)
|
|
- [open-webui](https://github.com/open-webui/open-webui)
|
|
- [jellyfin](https://github.com/jellyfin/jellyfin)
|
|
- [cloudflared](https://github.com/cloudflare/cloudflared)
|
|
- [podman](https://github.com/containers/podman)
|