From b8dd31abfed79b97b1349c2f8bc9f9527b8d0dfa Mon Sep 17 00:00:00 2001 From: Crony Akatsuki Date: Sat, 25 Mar 2023 21:24:34 +0100 Subject: [PATCH] Update readme with how to host and run with docker. --- README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/README.md b/README.md index e50a42f..465853a 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,37 @@ # UpFast simple tool to host file upload and sharing. + +## 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. + + +```bash +# Create the virtual environment +python -m venv venv + +# Activate the virtual environment +source venv/bin/activate + +# Install all the requirements +pip install -r requirements.txt + +# Run the project +uvicorn main:app --host 0.0.0.0 --port 8000 +``` + +### 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 a upload directory to where you run it from so you can replace ./upload with a different path to save uploaded stuff.