Simple live collaboration notepad with websockets and FastAPI. https://aukpad.com
Find a file
2025-09-28 20:58:12 +02:00
app.py ADD DESCRIPTION env var and /system/info endpoint 2025-09-20 19:44:18 +02:00
Dockerfile init public v0.2.2 2025-09-20 19:02:26 +02:00
favicon.ico init public v0.2.2 2025-09-20 19:02:26 +02:00
LICENSE init public v0.2.2 2025-09-20 19:02:26 +02:00
README.md ADD README information about GH mirror, functions, issue tracker, IRC 2025-09-28 20:58:12 +02:00

Aukpad

Simple live collaboration notepad with websockets and FastAPI.

Issue tracker | Libera Chat #aukpad

  • Status: Beta - expect minor changes.
  • Instance/Demo: aukpad.com
  • Inspired by:

The goal is to keep it simple! For feature-rich solutions are hedgedoc or codeMD.


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

Not planned:

  • accounts / RBAC

Usage

Creating pad with curl

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.


Notes


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