|
| 1 | +<h1 align="center">FilesService</h1> |
| 2 | + |
| 3 | +<h4 align="center"> |
| 4 | +A simple service for your web-based files. |
| 5 | +<br> |
| 6 | +Works with PHP 5.6+ |
| 7 | +</h4> |
| 8 | + |
| 9 | +<p align="center"> |
| 10 | + <a href="https://github.com/utarwyn/files-php-service/actions?query=workflow%3ABuild"><img src="https://github.com/utarwyn/files-php-service/workflows/Build/badge.svg" alt="Publishing status"></a> |
| 11 | + <a href="https://github.com/utarwyn/files-php-service/actions?query=workflow%3APublish"><img src="https://github.com/utarwyn/files-php-service/workflows/Publish/badge.svg" alt="Publishing status"></a> |
| 12 | + <a href="https://packagist.org/packages/utarwyn/files-php-service"><img src="https://poser.pugx.org/utawyn/files-php-service/v/stable.svg" alt="Latest Stable Version"></a> |
| 13 | + <a href="https://github.com/utarwyn/files-php-service/blob/master/LICENSE"><img src="https://poser.pugx.org/utarwyn/files-php-service/license.svg" alt="License"></a> |
| 14 | +</p> |
| 15 | + |
| 16 | +FilesService is a **lightweight self-hosted service** which provides an easy way to manage web-based files. |
| 17 | +It supplies a documented **RESTful API** and an authentication system based on **OAuth2** to store files in a protected bucket. |
| 18 | + |
| 19 | +Installation |
| 20 | +------------ |
| 21 | + |
| 22 | +1. Install the service with Composer:\ |
| 23 | + `composer create-project utarwyn/files-php-service` |
| 24 | +2. Move file `.env.example` to `.env` and configure it. |
| 25 | +3. Use Nginx or Apache to provide an access to the `public` folder. |
| 26 | + |
| 27 | +Use it with Docker |
| 28 | +------------ |
| 29 | + |
| 30 | +1. Pull the latest image from [DockerHub][1]:\ |
| 31 | + `docker pull utarwyn/files-php-service` |
| 32 | +2. Create a folder to store uploaded files somewhere. |
| 33 | +3. Create a `.env` file based on the `.env.example` in the repository. |
| 34 | +4. Start the Docker container by providing their paths:\ |
| 35 | + `docker run -v /home/.env:/app/.env -v /home/storage:/app/storage -p 80:8080 utarwyn/files-php-service` |
| 36 | + |
| 37 | +Documentation |
| 38 | +------------ |
| 39 | + |
| 40 | +> Soon! |
| 41 | +
|
| 42 | +License |
| 43 | +-------- |
| 44 | + |
| 45 | +FilesService is open-sourced software licensed under the [MIT license][2]. |
| 46 | + |
| 47 | +--- |
| 48 | +> GitHub [@utarwyn][3] · Twitter [@Utarwyn][4] |
| 49 | +
|
| 50 | +[1]: https://hub.docker.com/r/utarwyn/files-php-service |
| 51 | +[2]: https://opensource.org/licenses/MIT |
| 52 | +[3]: https://github.com/utarwyn |
| 53 | +[4]: https://twitter.com/Utarwyn |
0 commit comments