95 lines
2.4 KiB
Markdown
95 lines
2.4 KiB
Markdown
# Aukpad
|
|
|
|
Simple **live collaboration notepad** with websockets and FastAPI.
|
|
|
|
[Issue tracker](https://git.uphillsecurity.com/cf7/aukpad/issues) | `Libera Chat #aukpad`
|
|
|
|
- Status: Beta - expect minor changes.
|
|
- Instance/Demo: [aukpad.com](https://aufkpad.com/)
|
|
- Inspired by:
|
|
- [Rustpad](https://github.com/ekzhang/rustpad)
|
|
|
|
The goal is to keep it simple! For feature-rich solutions are [hedgedoc](https://github.com/hedgedoc/hedgedoc) or [codeMD](https://github.com/hackmdio/codimd).
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
**Available**:
|
|
- live collab notepad
|
|
- line numbers
|
|
- custom path for more privacy
|
|
- optional caching with valkey/redis
|
|
- pad creation with HTTP post requests with curl (see *Usage*)
|
|
- `[pad_id]/raw` HTTP endpoint
|
|
|
|
**Ideas**:
|
|
[Check out the open feature requests](https://git.uphillsecurity.com/cf7/aukpad/issues?q=&type=all&sort=&state=open&labels=12&milestone=0&project=0&assignee=0&poster=0&archived=false)
|
|
|
|
**Not planned**:
|
|
- accounts / RBAC
|
|
|
|
---
|
|
|
|
## Usage
|
|
|
|
**Creating pad with curl**
|
|
|
|
```bash
|
|
curl -X POST -d "Cheers" https://aukpad.com/ # string
|
|
curl -X POST https://aukpad.com --data-binary @- < file.txt # file
|
|
ip -br a | curl -X POST https://aukpad.com --data-binary @- # command output
|
|
```
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### Environment Variables
|
|
|
|
The following environment variables can be configured:
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `USE_VALKEY` | `false` | Enable Valkey/Redis caching. Set to `true` to enable |
|
|
| `VALKEY_URL` | `redis://localhost:6379/0` | Redis/Valkey connection URL |
|
|
| `MAX_TEXT_SIZE` | `5` | Maximum text size in MB (5MB default) |
|
|
| `MAX_CONNECTIONS_PER_IP` | `10` | Maximum concurrent connections per IP address |
|
|
| `RETENTION_HOURS` | `48` | How long to retain pads in hours (48 hours default) |
|
|
| `DESCRIPTION` | `powered by aukpad.com` | Instance description shown on info page |
|
|
|
|
### Running
|
|
|
|
WORK IN PROGRESS
|
|
|
|
---
|
|
|
|
## Security
|
|
|
|
For security concerns or reports, please contact via `hello a t uphillsecurity d o t com` [gpg](https://uphillsecurity.com/gpg).
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
- [Github Mirror available](https://github.com/CaffeineFueled1/aukpad)
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
**Apache License**
|
|
|
|
Version 2.0, January 2004
|
|
|
|
http://www.apache.org/licenses/
|
|
|
|
- ✅ Commercial use
|
|
- ✅ Modification
|
|
- ✅ Distribution
|
|
- ✅ Patent use
|
|
- ✅ Private use
|
|
- ✅ Limitations
|
|
- ❌Trademark use
|
|
- ❌Liability
|
|
- ❌Warranty
|