73 lines
1.7 KiB
Markdown
73 lines
1.7 KiB
Markdown
|
# 🔥 Forge Paste
|
||
|
|
|
||
|
|
A lightweight, self-hosted paste server with a clean UI. Hastebin-compatible API.
|
||
|
|
|
||
|
|
**Zero dependencies** — runs on Python 3.10+ with the standard library only. Uses SQLite for storage.
|
||
|
|
|
||
|
|
## Quick Install
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Clone
|
||
|
|
git clone https://github.com/everestmcarthur/forge-paste.git /opt/forge-paste
|
||
|
|
|
||
|
|
# Create data directory
|
||
|
|
sudo mkdir -p /var/lib/forge-paste
|
||
|
|
sudo chown www-data:www-data /var/lib/forge-paste
|
||
|
|
|
||
|
|
# Install systemd service
|
||
|
|
sudo cp /opt/forge-paste/forge-paste.service /etc/systemd/system/
|
||
|
|
sudo systemctl daemon-reload
|
||
|
|
sudo systemctl enable --now forge-paste
|
||
|
|
```
|
||
|
|
|
||
|
|
## API
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Create a paste
|
||
|
|
curl -X POST -d "your text here" https://logs.yourdomain.com/api/paste
|
||
|
|
# → {"key": "abc123", "url": "https://logs.yourdomain.com/abc123"}
|
||
|
|
|
||
|
|
# Hastebin-compatible
|
||
|
|
curl -X POST -d "your text" https://logs.yourdomain.com/api/documents
|
||
|
|
# → {"key": "abc123"}
|
||
|
|
|
||
|
|
# Get raw text
|
||
|
|
curl https://logs.yourdomain.com/api/raw/abc123
|
||
|
|
|
||
|
|
# Get JSON
|
||
|
|
curl https://logs.yourdomain.com/api/documents/abc123
|
||
|
|
# → {"key": "abc123", "data": "your text"}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Wings/Spark Integration
|
||
|
|
|
||
|
|
Upload diagnostics directly:
|
||
|
|
```bash
|
||
|
|
sudo spark diagnostics --hastebin-url=https://logs.yourdomain.com
|
||
|
|
```
|
||
|
|
|
||
|
|
Upload logs via curl:
|
||
|
|
```bash
|
||
|
|
tail -n 300 /var/www/forge/storage/logs/laravel-$(date +%F).log | curl -X POST --data-binary @- https://logs.yourdomain.com/api/paste
|
||
|
|
```
|
||
|
|
|
||
|
|
## Caddy Reverse Proxy
|
||
|
|
|
||
|
|
```
|
||
|
|
logs.yourdomain.com {
|
||
|
|
reverse_proxy 127.0.0.1:7890
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
| Env / Flag | Default | Description |
|
||
|
|
|---|---|---|
|
||
|
|
| `FORGE_PASTE_PORT` / `--port` | 7890 | Listen port |
|
||
|
|
| `FORGE_PASTE_HOST` / `--host` | 127.0.0.1 | Listen address |
|
||
|
|
| `FORGE_PASTE_DB` / `--db` | /var/lib/forge-paste/pastes.db | SQLite database path |
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT
|