dingbatter/shebangrun repository overview

⁠shebang.run

A platform for hosting and sharing shell scripts and code snippets with built-in versioning, encryption, and signing.

⁠Features

• Script Versioning - Auto-incrementing versions with immutable history
• End-to-End Encryption - RSA-4096 + ChaCha20-Poly1305 encryption
• Access Control - Private, unlisted, and public scripts with token-based sharing
• OAuth Integration - GitHub and Google authentication
• Key Management - Generate or import RSA keypairs for signing/encryption
• Rate Limiting - Configurable per-user limits
• Admin Panel - User management and system configuration
• Python Library - Full API client with decryption support

⁠Quick Start

bash docker run -d
-p 8080:8080
-e JWT_SECRET="your-secret-key"
-e DATABASE_URL="root:password@tcp(mariadb:3306)/shebang?parseTime=true"
dingbatter/shebangrun:latest

⁠Docker Compose

yaml version: '3.8' services: app: image: dingbatter/shebangrun:latest ports: - "8080:8080" environment: - JWT_SECRET=your-secret-key - DATABASE_URL=root:password@tcp(mariadb:3306)/shebang?parseTime=true - STORAGE_TYPE=s3 depends_on: - mariadb - minio

Full docker-compose.yml: https://github.com/skibare87/shebangrun/blob/main/docker-compose.yml⁠

⁠Usage

⁠Retrieve Scripts

bash

⁠Latest version

curl https://your-domain.com/username/scriptname⁠ | sh

⁠Specific version

curl https://your-domain.com/username/scriptname@v5⁠ | sh

⁠Tagged version

curl https://your-domain.com/username/scriptname@dev⁠ | sh

⁠Python Library

bash pip install shebangrun

python from shebangrun import run

⁠Fetch and execute

run(username="user", script="deploy", eval=True)

⁠Decrypt encrypted scripts

run(username="user", script="private", key=open("private.pem").read())

⁠Environment Variables

⁠Architecture

• Backend: Go 1.22
• Database: MariaDB 11
• Storage: S3-compatible (MinIO) or local filesystem
• Frontend: htmx + Alpine.js + Tailwind CSS
• Encryption: RSA-4096, ChaCha20-Poly1305, SHA-256

⁠Links

• Website: https://shebang.run⁠
• GitHub: https://github.com/skibare87/shebangrun⁠
• Documentation: https://shebang.run/docs⁠
• Python Package: https://pypi.org/project/shebangrun/⁠

⁠License

MIT License