A file hosting application with an emphasis on serving technology communities.
PHP HTML JavaScript Shell Other

readme.md

uPste

Language License IRC Flattr this git repo

uPste is a 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.

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

Screenshots

Index Preview User Preview Uploads Preview

Requirements

  • The PHP GD extension.
  • The ability to install Laravel.
  • Any database supported by Eloquent.
  • Laravel Elixir.
  • A little bit of command line experience.

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 software, but you MUST keep the /uploads location intact for x-accel/x-sendfile to work if you intend to use them.

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

WARNING: It is strongly recommended you check the release notes for each new version to see if there are any breaking changes that affect you.

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 you change .env values and they don't seem to be doing anything, try running composer recache to rebuild the site caches, including the config cache.