Add readme.md
This commit is contained in:
94
readme.md
Normal file
94
readme.md
Normal file
@ -0,0 +1,94 @@
|
|||||||
|
|
||||||
|
## FileKeeper
|
||||||
|
FileKeeper is a file hosting service built with pure Golang and some JavaScript. It allows users to securely upload, store, and manage files on a server.
|
||||||
|
|
||||||
|
|
||||||
|
## Environment Variables
|
||||||
|
|
||||||
|
To run this project, you will need to add the following environment variables to your .env file [example file](https://gist.github.com/fossyy/a15e6806cd33d0ee74611ff410c9d1aa)
|
||||||
|
|
||||||
|
`SERVER_HOST`
|
||||||
|
|
||||||
|
`SERVER_PORT`
|
||||||
|
|
||||||
|
`DOMAIN`
|
||||||
|
|
||||||
|
`CORS_PROTO`
|
||||||
|
|
||||||
|
`CORS_LIST`
|
||||||
|
|
||||||
|
`CORS_METHODS`
|
||||||
|
|
||||||
|
`DB_HOST`
|
||||||
|
|
||||||
|
`DB_PORT`
|
||||||
|
|
||||||
|
`DB_USERNAME`
|
||||||
|
|
||||||
|
`DB_PASSWORD`
|
||||||
|
|
||||||
|
`DB_NAME`
|
||||||
|
|
||||||
|
`SMTP_HOST`
|
||||||
|
|
||||||
|
`SMTP_PORT`
|
||||||
|
|
||||||
|
`SMTP_USER`
|
||||||
|
|
||||||
|
`SMTP_PASSWORD`
|
||||||
|
|
||||||
|
`SESSION_NAME`
|
||||||
|
|
||||||
|
`SESSION_MAX_AGE`
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
#### Running with Docker
|
||||||
|
|
||||||
|
1. Ensure you have Docker installed on your system. If not, download and install Docker from [here](https://docs.docker.com/get-docker/).
|
||||||
|
|
||||||
|
2. Clone the repository:
|
||||||
|
```bash
|
||||||
|
docker pull fossyy/filekeeper:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Install dependencies:
|
||||||
|
```bash
|
||||||
|
docker run -d --name filekeeper -v /path/to/data:/src/uploads -p 8000:8000 fossyy/filekeeper:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Access the application in your web browser:
|
||||||
|
http://localhost:8080
|
||||||
|
|
||||||
|
#### Running Locally
|
||||||
|
If you prefer to run the app locally without Docker, follow these steps:
|
||||||
|
1. Clone the repository:
|
||||||
|
```bash
|
||||||
|
https://github.com/fossyy/filekeeper.git
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Install dependencies::
|
||||||
|
```bash
|
||||||
|
cd filekeeper
|
||||||
|
go mod tidy
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Build and run the application:
|
||||||
|
```bash
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Access the application in your web browser:
|
||||||
|
http://localhost:8080
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Demo
|
||||||
|
|
||||||
|
https://filekeeper.fossy.my.id
|
||||||
|
|
||||||
|
|
||||||
|
## Authors
|
||||||
|
|
||||||
|
- [@Bagas Aulia Rezki (fossyy)](https://github.com/fossyy)
|
||||||
|
|
Reference in New Issue
Block a user