Update readme
This commit is contained in:
parent
8f529057c0
commit
42d2aef650
69
README.md
69
README.md
@ -1,68 +1,3 @@
|
|||||||
# UpFast
|
# Rewrite
|
||||||
|
|
||||||
Simple tool for uploading and sharing files that you can self-host.
|
Rewriting upfast in go mostly for learning, and in general even faster and more robust tool.
|
||||||
|
|
||||||
## 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
|
|
||||||
|
|
||||||
To run on a regular system I recommend to use a virtual environment to install the dependencies and run the project from there.
|
|
||||||
|
|
||||||
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).
|
|
||||||
|
|
||||||
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
|
|
||||||
```
|
|
||||||
|
|
||||||
The sample command will need an upload directory, you can replace `./upload` with a different path to save uploaded stuff.
|
|
||||||
|
|
||||||
### 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
|
|
||||||
```
|
|
||||||
|
|
||||||
# Contributions
|
|
||||||
|
|
||||||
Thanks [TLasT](https://craftmenners.men) on his help with testing and documentation.
|
|
||||||
|
Loading…
Reference in New Issue
Block a user