TRTL3

TRTL3🐢 is a file storage service written in GO designed for developers who want to build things without the complexity of cloud services or external dependencies. If you're building something with files uploads, downloads, and blobs organization — TRTL3 is a great starting point!

• Getting Started
• Usage
• Features

After Install Docker/Docker Compose you can install TRTL3 using this command:

docker run -d --name trtl3 -p 7713:7713 -e TOKEN=your_secret_token nothiaki/trtl3:latest

So the service will be running on http://localhost:7713/ and you can use by REST or use SDK's.

If you want to use docker compose you can add it on the file:

services:

  trtl3:
    image: nothiaki/trtl3:latest
    ports:
      - 7713:7713
    environment:
      - TOKEN=your_token_here
      - WORKERS=10
      - JOB_INTERVAL=5

You can use TRTL3 by REST api or our official SDKs: Go on our website to learn more.

SDKs:

• GO ... soon in nodejs and java

curl -X POST http://localhost:7713/blobs \
  -H "Authorization: Bearer your_token_here" \
  -F "bucket=my-bucket" \
  -F "blob=@/path/to/your/file.jpg"

curl -X GET "http://localhost:7713/blobs?bucket=my-bucket" \
  -H "Authorization: Bearer your_token_here"

curl -X POST http://localhost:7713/blobs/sign \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bucket": "my-bucket",
    "id": "file-id",
    "ttl": 60,
    "once": false
  }'

curl -X GET "http://localhost:7713/b?sign=your_signed_token"

curl -X GET "http://localhost:7713/blobs/download/my-bucket/file-id" \
  -H "Authorization: Bearer your_token_here" \
  -o downloaded_file.jpg

curl -X GET "http://localhost:7713/health"

• File Upload & Storage: Upload files with automatic ID generation and metadata tracking
• Bucket Organization: Organize files into logical buckets (like folders)
• Signed URLs: Generate temporary, secure URLs for file access without authentication
• REST API: Complete RESTful API for all operations
• Authentication: Token-based authentication for secure access
• Automatic Cleanup: Background jobs to clean orphaned files and expired signatures

• Async Processing: Queue-based file processing with configurable workers
• Embedded Database: Uses DuckDB for metadata storage (no external dependencies)
• Docker Ready: Easy deployment with Docker and Docker Compose
• File System Storage: Simple file-based storage with automatic directory creation
• TTL Support: Configurable expiration for signed URLs (1-1440 minutes)
• One-time Access: Optional single-use URLs for sensitive files

• Token Authentication: Bearer token authentication for API access
• Signed URLs: Time-limited, secure access to files
• Input Validation: File type and size validation
• Secure File Naming: Automatic secure file naming to prevent conflicts