How to install Uguu on a Linux server?

Follow the wiki documentation: you'll need to set up Nginx, PHP-8.3, a database like SQLite or MySQL, and use Bun to compile the project. Specific steps vary by distribution, so check the wiki for details.

Uguu vs Pomf: which is better for self-hosting?

Uguu is a modern fork of Pomf with updated support for PHP-8.3 and enhanced security features. If you prefer a more current and actively maintained solution, Uguu is better; Pomf might be simpler but older.

Can Uguu handle permanent file storage?

Yes, it can function as a permanent host, but it's designed for temporary sharing, so you may need to manually manage files as it lacks automatic cleanup or backup features.

How to integrate Uguu with ShareX?

Configure ShareX to use Uguu's upload API by pointing it to your instance's endpoint, allowing automatic screenshot uploads with customizable response formats like JSON or text.

What security features does Uguu have?

It includes file hash blacklisting to block known unwanted content, MIME/extension whitelisting/blacklisting for upload control, and upload rate limiting to prevent abuse and DDoS attacks.

Is Uguu good for high-traffic sites?

Uguu is lightweight but PHP-based, so performance under high concurrent uploads may require server optimization. It's not inherently scalable out-of-the-box, so consider load balancing for heavy traffic.

Open-Awesome

Uguu

GPL-3.0PHPv.1.9.9Self-Hosted

A simple lightweight temporary file hosting and sharing platform with drag & drop, paste, and API upload support.

Visit Website GitHub

1.2k stars126 forks0 contributors

What is Uguu?

Uguu is a simple, lightweight file hosting platform designed primarily for temporary file sharing, but it can also serve as a permanent file host. It allows users to upload files quickly without registration through drag & drop, paste, or click methods, and provides an API for programmatic uploads. The project solves the need for a minimal, self-hostable file sharing service with security controls like rate limiting and file blacklisting.

Target Audience

Developers, system administrators, or individuals needing a self-hosted, temporary file sharing solution with API support and integration with tools like ShareX.

Value Proposition

Developers choose Uguu for its simplicity, lightweight design, and flexibility—it supports multiple databases and upload methods while being easy to self-host with minimal dependencies. Its open-source nature and security features like file blacklisting make it a reliable alternative to proprietary file hosts.

Overview

Uguu is a simple lightweight temporary file host with support for drop, paste, click and API uploading.

Use Cases

Best For

Self-hosting a temporary file sharing service for teams or communities
Integrating file uploads into applications via a flexible API
Quickly sharing screenshots or files using drag & drop or paste
Setting up a lightweight file host with security controls like rate limiting
Replacing proprietary file hosts with an open-source, customizable solution
Using ShareX or similar tools for automated uploads to a private host

Not Ideal For

Projects requiring user authentication and granular access controls for file management
Enterprises needing compliance features like audit logs or data retention policies
High-traffic applications requiring built-in load balancing or CDN integration

Pros & Cons

Pros

No Registration Required

Supports one-click uploading with drag & drop, paste, or click methods, enabling immediate file sharing without user accounts.

Flexible API Support

Provides upload API with multiple response formats (JSON, HTML, Text, CSV), making it easy to integrate programmatically into custom applications.

Security Controls

Includes file extension/MIME whitelisting/blacklisting and upload rate limiting to prevent abuse and block unwanted content.

Tool Integration

Compatible with ShareX and other screenshot tools, streamlining automated upload workflows for developers and users.

Cons

Complex Setup Process

Requires configuring Nginx, PHP-8.3, a database (SQLite/MySQL/PostgreSQL), and Bun for compilation, which can be challenging for those unfamiliar with server administration.

Limited Documentation

Installation and configuration guides are on a separate wiki, which may lack detailed examples or be less maintained than in-repo documentation.

Minimal Feature Set

Lacks advanced features like user accounts, file versioning, or built-in encryption, making it unsuitable for scenarios needing robust management or security.

Frequently Asked Questions

Related Projects

transfer.sh

Easy and fast file sharing from the command-line.

Stars15,834

Forks1,586

Last commit5 months ago

OnionShare

Securely and anonymously share files, host websites, and chat with friends using the Tor network

Stars6,941

Forks700

Last commit1 month ago

Zipline

A ShareX/file upload server that is easy to use, packed with features, and with an easy setup!

Stars3,120

Forks234

Last commit5 days ago

PicoShare

A minimalist, easy-to-host service for sharing images and other files

Stars2,912

Forks201

Last commit17 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub