pivilion/README.md

45 lines
2.4 KiB
Markdown
Raw Normal View History

2016-11-29 01:24:59 +00:00
[Manual](https://gitlab.com/hacklab01/pivilion/wikis/pivilion-manual-setup)
2016-11-26 11:01:28 +00:00
2022-06-30 21:55:29 +00:00
Pivilion is a decentralizing open source darknet web server project and gallery management software for the creation of autonomous & uncensored digital media art online galleries. It runs on low cost Raspberry Pi hardware and is built on top of Raspbian GNU/Linux with a server and Tor networking built in, utilizing the Tor network to host exhibitions out of the box.
2016-11-25 00:19:44 +01:00
2022-06-30 21:55:29 +00:00
Each Pivilion device receives a Tor onion domain automatically the first time its activated. The system provides the user with a CMS for publishing multimedia or websites within a gallery. Its designed so that the author-curator can use any network (even public networks behind firewalls) to host an online exhibition.
2016-11-25 00:19:44 +01:00
2022-06-30 21:55:29 +00:00
Pivilion is primarily a long-term, open-ended new media art project propagating autonomous modes of art in the darknet, and is continuously including a large number of artists and cultural workers in its creation.
2016-11-25 00:19:44 +01:00
2022-06-30 21:55:29 +00:00
The documentation and the announcement of global #pivilion_dot events are available via the central website, hosted both on clearnet and as a hidden service on the Tor network, while the entire open source system is available via git.
2016-11-25 00:19:44 +01:00
2022-06-30 21:55:29 +00:00
Project website: [pivilion.net](https://pivilion.net/)
2016-11-25 00:19:44 +01:00
Required hardware:
2022-06-30 22:03:23 +00:00
- Raspberry Pi with WiFi
2016-11-24 23:25:07 +00:00
- min 8 GB SD card
2022-06-30 21:55:29 +00:00
- battery or power adapter
## Installation on current Raspberry Pi OS
Pivilion supports Raspberry Pi OS Bullseye, Bookworm, and Trixie. Bookworm and
newer systems use NetworkManager automatically; Bullseye installations using
`dhcpcd` use the legacy hostapd backend. The repository layout and the original
commands are preserved on both backends.
On a fresh Raspberry Pi OS Lite installation:
```sh
git clone https://gitlab.com/hacklab01/pivilion.git
cd pivilion
sudo ./install.sh
sudo reboot
```
The installer defaults to the user that invoked `sudo`, not to a hard-coded
`pi` account. To customize paths, startup mode, hotspot SSID, or Wi-Fi
interface, copy `pivilion.conf.example` to `/boot/firmware/pivilion.conf` (or
`/etc/pivilion.conf`) and edit it before installing. The hotspot is intentionally
open and passwordless.
Use `pikey` to save upstream Wi-Fi credentials, then `onion` and reboot to host
through Tor. Use `hotspot` and reboot to run the local captive gallery at
`http://10.1.1.1/`. HTTPS interception is intentionally not attempted because a
local captive portal cannot present valid certificates for arbitrary sites.