readme.md

uPste

uPste is a private file hosting application with an emphasis on serving technology communities.

It is released under the GNU Affero General Public License.

The official demo of this project is available at https://u.pste.pw, although not very useful without an account.

Interested in contributing, want some help or just have some questions? Join us on irc.rizon.net in #leliana

Screenshots

Requirements

• The PHP GD extension.
• The ability to install Laravel.
• Any database supported by Eloquent.
• Laravel Elixir.
• A little bit of command line experience.
• A web server that understands X-Accel-Redirect

Installation

We'll assume you already have a database, setting that up is beyond the scope of this readme.

git clone https://github.com/TheReverend403/uPste
cd uPste
composer install # Installs laravel, all dependencies, npm dependencies, compiles assets and generates your app key.

Open .env in the root directory of uPste and edit the settings within to suit your site. Make sure to read what each one does, and feel free to ask if you're not sure.

php artisan migrate # Creates your database schema

The next, and last part is entirely dependent you and how you want to configure your webserver, but you're basically going to want two domains (or subdomains).

There is an example nginx config in the root of this repository.
Feel free to adapt it to your server, but you MUST keep the /uploads location intact for x-accel to work.

That's it, you're done! Now just navigate to your site and register.
The first user registered will be automatically enabled and made an admin, so take measures to make sure this is you.

Upgrading

Upgrading is easy. Just run the following commands, and make sure to check .env.example for any new config options you need to set.

cd /path/to/uPste
git pull
composer update

If everything went well and you didn't get any errors, you can now bring your site back online with php artisan up