3 Uguu is a simple temporary file uploading and sharing platform where files get deleted after X amount of time.
7 - One click uploading, no registration required
8 - A minimal, modern web interface
9 - Drag & drop supported
10 - Upload API with multiple response choices
15 - Supports
[ShareX](https://getsharex.com/) and other screenshot tools
19 See the real world example at
[uguu.se](https://uguu.se).
23 Original development environment is Nginx + PHP5.3 + SQLite, but is confirmed to
24 work with Apache
2.4 and newer PHP versions like PHP7.3.
28 For the purposes of this guide, we won't cover setting up Nginx, PHP, SQLite,
29 Node, or NPM. So we'll just assume you already have them all running well.
31 **NPM/Node is only needed to compile the files, Uguu runs on PHP.**
35 First you must get a copy of the uguu code. To do so, clone this git repo.
37 git clone https://github.com/nokonoko/uguu
40 Assuming you already have Node and NPM working, compilation is easy.
42 Run the following commands to do so, please configure
`dist.json` before you compile.
50 make install DESTDIR=/desired/path/for/site
52 After this, the uguu site is now compressed and set up inside
`dist/`, or, if specified,
`DESTDIR`.
56 Front-end related settings, such as the name of the site, and maximum allowable
57 file size, are found in
`dist.json`. Changes made here will
58 only take effect after rebuilding the site pages. This may be done by running
59 `make` from the root of the site directory.
61 Back-end related settings, such as database configuration, and path for uploaded files, are found in
`includes/settings.inc.php`. Changes made here take effect immediately. Change the following settings:
63 define('UGUU_DB_CONN', 'sqlite:/path/to/db/uguu.sq3');
64 define('UGUU_FILES_ROOT', '/path/to/file/');
65 define('UGUU_URL', 'https://subdomainforyourfiles.your.site');
68 If you intend to allow uploading files larger than
2 MB, you may also need to
69 increase POST size limits in
`php.ini` and webserver configuration. For PHP,
70 modify
`upload_max_filesize` and
`post_max_size` values. The configuration
71 option for nginx webserver is
`client_max_body_size`.
73 Edit checkdb.sh and checkfiles.sh to the proper paths:
75 sqlite3 /path/to/db/uguu.sq3 "DELETE FROM files WHERE date <= strftime('%s', datetime('now', '-1 day'));"
78 find /path/to/files/ -mmin +1440 -exec rm -f {} \;
80 Then add them to your crontab:
82 0,30 * * * * bash /path/to/checkfiles.sh
83 0,30 * * * * bash /path/to/checkdb.sh
86 These scripts check if DB entries and files are older then
24 hours and if they are deletes them.
90 Blocking certain filetypes from being uploaded can be changed by editing the following settings in
`includes/settings.inc.php`:
92 define('CONFIG_BLOCKED_EXTENSIONS', serialize(['exe', 'scr', 'com', 'vbs', 'bat', 'cmd', 'htm', 'html', 'jar', 'msi', 'apk', 'phtml']));
93 define('CONFIG_BLOCKED_MIME', serialize(['application/msword', 'text/html', 'application/x-dosexec', 'application/java', 'application/java-archive', 'application/x-executable', 'application/x-mach-binary']));
96 By default the most common malicious filetypes are blocked.
98 ## Using SQLite as DB engine
100 We need to create the SQLite database before it may be used by uguu.
101 Fortunately, this is incredibly simple.
103 First create a directory for the database, e.g.
`mkdir /var/db/uguu`.
104 Then, create a new SQLite database from the schema, e.g.
`sqlite3 /var/db/uguu/uguu.sq3 -init /home/uguu/sqlite_schema.sql`.
105 Then, finally, ensure the permissions are correct, e.g.
107 chown www-data:www-data /var/db/uguu
108 chmod 0750 /var/db/uguu
109 chmod 0640 /var/db/uguu/uguu.sq3
112 Finally, edit
`includes/settings.inc.php` to indicate this is the database engine you would like to use. Make the changes outlined below
114 define('UGUU_DB_CONN', '[stuff]'); ---> define('UGUU_DB_CONN', 'sqlite:/var/db/uguu/uguu.sq3');
115 define('UGUU_DB_USER', '[stuff]'); ---> define('UGUU_DB_USER', null);
116 define('UGUU_DB_PASS', '[stuff]'); ---> define('UGUU_DB_PASS', null);
119 *NOTE: The directory where the SQLite database is stored, must be writable by the web server user*
121 ## Nginx example config
123 I won't cover settings everything up, here are some Nginx examples. Use
[Letsencrypt](https://letsencrypt.org) to obain a SSL cert.
130 server_name www.yourdomain.com yourdomain.com;
133 ssl_certificate /path/to/fullchain.pem;
134 ssl_certificate_key /path/toprivkey.pem;
135 ssl_protocols TLSv1.2 TLSv1.3;
137 root /path/to/uguu/dist/;
140 index index.html index.php;
142 location ~* \.(ico|css|js|ttf)$ {
147 fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
148 fastcgi_intercept_errors on;
149 fastcgi_index index.php;
150 fastcgi_split_path_info ^(.+\.php)(.*)$;
151 include fastcgi_params;
152 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
157 Subdomain serving files (do not enable PHP here):
161 server_name www.subdomain.serveryourfiles.com subdomain.serveryourfiles.com;
164 ssl_certificate /path/to/fullchain.pem;
165 ssl_certificate_key /path/to/privkey.pem;
166 ssl_protocols TLSv1.2 TLSv1.3;
168 root /path/where/uploaded/files/are/stored/;
175 To redirect HTTP to HTTPS make a config for each domain like so:
179 server_name www.domain.com domain.com;
180 return 301 https://domain.com$request_uri;
185 To upload using curl or make a tool you can post using:
187 curl -i -F files[]=@yourfile.jpeg https://uguu.se/upload.php (JSON Response)
192 Hit me up at
[@nekunekus](https://twitter.com/nekunekus) or email me at neku@pomf.se
196 Uguu is based on
[Pomf](http://github.com/pomf/pomf).
200 Uguu is free software, and is released under the terms of the Expat license. See