wastebin

wastebin is an open-source, self-hosted web application used for storing and sharing text snippets. It functions as a minimal pastebin that allows users to upload text, set expiration dates, and share the resulting URLs. The software is distributed as a single binary and can be deployed on Linux or MacOS, or run as a Docker container. It is also available for installation via Nix flakes.

The application provides a browser-based interface with a variety of keyboard shortcuts for common actions, such as copying URLs to the clipboard, viewing raw text, or toggling line wrapping. It supports the creation of encrypted entries and the rendering of formatted text for better readability. Because it lacks built-in user authentication and advanced denial-of-service mitigations, it is intended to be run behind a reverse proxy or with specific rate-limiting rules when exposed to the internet.

Key features

• Encryption of entries using ChaCha20Poly1305 and argon2 hashed passwords
• Markdown rendering to HTML with support for GitHub-flavored tables and task lists
• Syntax highlighting for over 170 languages via syntect
• Automatic compression of pastes using zstd
• Paste expiration options including deletion after reading or by anonymous owners
• Eight color themes available in both light and dark modes
• QR code generation for accessing pastes on mobile devices
• Support for Chinese and German translations

Built with Rust using the axum framework and a SQLite3 backend, wastebin is designed for a low memory footprint. It includes a JSON API for programmatically creating pastes and a command-line tool called wastebin-ctl for interacting with the running server. The software is highly configurable via environment variables, allowing administrators to adjust the database path, cache size, maximum body size for POST requests, and the default paste expiration durations. It is aimed at users who need a lightweight, private way to share code snippets or notes without the overhead of a full wiki or document management system.

This is a minimal utility for temporary text storage and secure snippet sharing.