Document settings

This commit is contained in:
CronyAkatsuki 2023-11-01 16:39:59 +01:00
parent 4a0136c9a3
commit 8585fe9552

View File

@ -2,6 +2,12 @@
Simple tool for uploading and sharing files that you can self-host.
## Settings
All settings are controled by using a .env file, an example is in the repo.
- Upload only: You can make the instance to be upload only. In that case you need to manually delete the files from your hosting machine.
## How to host
### Regular system
@ -11,19 +17,23 @@ To run on a regular system I recommend to use a virtual environment to install t
We will also be setting up an specific user to run the app as safe as possible with a systemd service file for startup
#### Installing
```bash
./install.sh
```
#### Running
```bash
systemctl start upfast.service
```
#### Start on boot
```bash
systemctl enable upfast.service
```
### Docker
In the repo there is an included dockerfile to generate an image from the latest version of everything, to generate an image just run `docker build . -t upfast` (You need root privileges or to be in the docker group).
@ -31,6 +41,7 @@ In the repo there is an included dockerfile to generate an image from the latest
To run the docker container check the container id with `docker images` command.
> sample docker run command
```bash
sudo docker run -p 8000:8000 -v ./upload:/usr/src/app/upload CONTAINER_ID
```
@ -40,12 +51,14 @@ The sample command will need an upload directory, you can replace `./upload` wit
### Nginx Proxy setup
This is an example nginx proxy config for http
```bash
cp ./upfast-nginx /etc/nginx/sites-available/upfast
ln -sf /etc/nginx/sites-available/upfast /etc/nginx/sites-enabled/
```
> Load config
```bash
systemctl reload nginx
```