diff options
| author | Kana <[email protected]> | 2019-03-08 00:45:22 +0900 |
|---|---|---|
| committer | GitHub <[email protected]> | 2019-03-08 00:45:22 +0900 |
| commit | 77a5b856fece3bd8f44acd793c23ad834f7690da (patch) | |
| tree | 36f6337be3ff3ab2bcd89e6220d27a6e3932ef47 | |
| parent | wip (diff) | |
| download | host.fuwn.me-77a5b856fece3bd8f44acd793c23ad834f7690da.tar.xz host.fuwn.me-77a5b856fece3bd8f44acd793c23ad834f7690da.zip | |
Create README.md
| -rw-r--r-- | README.md | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..591e6c6 --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ + +[](https://raw.githubusercontent.com/kanadeko/Kuro/master/LICENSE) +[](https://discord.gg/5g6vgwn) +[](https://www.patreon.com/pitu) +[](https://www.buymeacoffee.com/kana) + +### Pre-requisites +This guide asumes a lot of things, including that you know your way around linux, nginx and internet in general. + +- Decently updated version of linux +- `node` package installed and at least at version 10 +- `build-essential` package installed to build some dependencies +- `ffmpeg` package installed if you want thumbnails +- `yarn` package installed. If you'd like to use npm instead change `package.json` accordingly +- A database, postgresql preferably. You can also fall back to sqlite3 by default. + +### Installing + +1. Clone the repository and `cd` into it +2. Run `yarn install` +3. Run `yarn setup` +4. Run `yarn migrate` +5. Run `yarn seed` + +Lolisafe is now installed, configured and ready. Now you need to serve it to the public by using a domain name. + +6. Check the [nginx](docs/nginx.md) file for a sample configuration that has every step to run lolisafe securely on production. +7. After you finish setting up nginx, you need to start lolisafe by using pm2. If you want to use something else, figure out how. Run the following commands: +```bash +pm2 start npm --name "lolisafe.api" -- run api +pm2 start npm --name "lolisafe.site" -- run site +``` +(More info on why pm2 [here](docs/pm2.md)) + +8. Profit + +### Cloudflare + +If you want to run your site through CloudFlare because of the obvious advantages it has, lolisafe has your back. Unless you manually modify the `.env` file, uploads through the website will be uploaded in chunks thus bypassing CloudFlare's 100mb upload limit per file. + +## Author + +**lolisafe** © [Pitu](https://github.com/Pitu), Released under the [MIT](https://github.com/WeebDev/lolisafe/blob/master/LICENSE) License.<br> +Authored and maintained by Pitu. + +> [lolisafe.moe](https://lolisafe.moe) · GitHub [@Pitu](https://github.com/Pitu) |