https://github.com/berrysauce/minbin
☁️ A lightweight self-hostable temporary pastebin service
https://github.com/berrysauce/minbin
docker dragonflydb fastapi pastebin redis self-hosted
Last synced: 2 months ago
JSON representation
☁️ A lightweight self-hostable temporary pastebin service
- Host: GitHub
- URL: https://github.com/berrysauce/minbin
- Owner: berrysauce
- License: gpl-3.0
- Created: 2025-07-30T18:47:30.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-02-08T22:36:47.000Z (4 months ago)
- Last Synced: 2026-02-09T03:59:54.005Z (4 months ago)
- Topics: docker, dragonflydb, fastapi, pastebin, redis, self-hosted
- Language: HTML
- Homepage: https://minb.in
- Size: 1.03 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
a minimal, ephemeral pastebin service.
[](https://github.com/berrysauce/minbin/actions/workflows/github-code-scanning/codeql)
[](https://github.com/berrysauce/minbin/actions/workflows/pylint.yml)
minbin is a minimal, ephemeral pastebin service built with simplicity and privacy in mind. it's self-hostable, open source, and ideal for quick, temporary sharing of snippets, logs, or notes.
pastes expire automatically after 1 hour, or immediately after being viewed (optional). you can view pastes through a clean HTML interface or directly as raw plaintext. a QR code is generated for each paste to make sharing even easier.
**→ check it out at [minb.in](https://minb.in/)**
### features
- ⚡ minimal UI
- ⏱️ ephemeral pastes (1 hour or one-time view)
- 🌐 accessible via browser or HTTP POST
- 👀 view in browser or as raw text
- 📱 QR code generation for easy sharing
- 🏠 self-hostable
### how to use
1. go to [minb.in](https://minb.in/)
2. paste your text/snippet
3. publish to get a short URL and QR code
4. share the link (e.g. `https://minb.in/aB01`)
5. view it raw: `https://minb.in/raw/aB01`
6. paste expires after 1 hour or after viewing once
you can also use minbin from your command line:
```bash
# share a file
curl --data-binary @example.txt https://minb.in
# share a string
curl -d "hello from the terminal!" https://minb.in
```
### self-hosting
minbin can be self-hosted by deploying it as a Docker container [(see GitHub package registry)](https://github.com/berrysauce/minbin/pkgs/container/minbin) or by one-click deploying it on [Railway](https://railway.com/deploy/minbin) *(referral link)*.
| Variable | Description | Default |
| ---------------- | ------------------------------------- | ------------------ |
| `APP_DOMAIN` | public domain used in generated links | `minb.in` |
| `DB_HOST` | redis hostname or container name | `dragonfly` |
| `DB_PORT` | redis port | `6379` |
| `DB_USER` | redis username | *(optional)* |
| `DB_PASS` | redis password | *(optional)* |
| `PASTE_EXPIRY` | paste expiration time in **minutes** | `60` (1 hour) |
| `MAX_PASTE_SIZE` | maximum paste size in **bytes** | `5242880` (5 MB) |
you can override these by passing them into Docker or setting them in your hosting environment. the standard configuration uses [DragonflyDB](https://www.dragonflydb.io/docs/getting-started) for the database, but any Redis-compatible database should do.
### license
```txt
minbin – a minimal, ephemeral pastebin service
Copyright (C) 2025 Paul Haedrich
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.
```