Getting Started

The simplest way to try this by directly build from the source or use go run command

#clone git
git clone https://github.com/odit-bit/cloudfs.git
cd cloudfs
go mod download

# run command
go run ./cmd/web 
# listen at localhost:8181

it will run the web server (html page) with all service using in-memory implementation and will be blank-state for every time it start visit localhost:8181

Feature

• User authentication
• Standard file operation (upload, download, delete).
• Share the file using time expiration generated url.
• include built-in implementation for testing

Architecture

Environment Variable

the architecture has 3 core implementation for managing data.

• user (postgres)
• blob (minio)
• token (redis)

http dependency:

• session-cookie (redis)

Blob

BLOB_MINIO_ENDPOINT
BLOB_MINIO_ACCESS_KEY
BLOB_MINIO_SECRET_ACCESS_KEY

User

USER_PG_URI

Token

TOKEN_REDIS_URI

Session

SESSION_REDIS_URI

Docker compose

Example to use remote infrastructure for the service with caddy as reverse proxy, Docker will build from Dockerfile and fetch the neccessary image.

# start
docker compose up -d
# visit caddy endpoint http://localhost:2080

# stop
docker compose down -v