streaming-file-server

latests VERSION: 4.3.5

full-stack java file server based on spring-boot / spring-* with no limitation for upload and download files

minimum java 8 is required
with postgres: docker-ce on windows 10 is required
if you on windows, use scoop to install java and required command line tools.

Installation

with postgres in docker

# database
wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/docker-compose.yml
docker-compose -f docker-compose.yml up -d

# file-items data service
wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/file-items-service-4.3.5.jar
bash file-items-service-4.3.5.jar --spring.profiles.active=db-pg

# file server
wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/file-server-4.3.5.jar
bash file-server-4.3.5.jar --app.upload.path=./path/to/file-storage

# cleanup
docker-compose -f docker-compose.yml down -v

or simply using shell-script

wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/application.bash

# start
bash application.bash start ./path/to/file-storage

# stop
bash application.bash stop

# cleanup
bash application.bash clean ./path/to/file-storage

note: tested on osx with localhost docker

installed binaries: wget, docker-compose, bash and of course java are required

for windows use https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/application.cmd

@rem start
application.cmd start path\to\file-storage

@rem stop
application.cmd stop

@rem cleanup
application.cmd clean path\to\file-storage

note: tested on windows 10 with localhost docker for postgres

installed binaries: which, wget, docker-compose, taskkill, mkdir and of course java (binaries: java and jps) are required

with h2 in-memory database

wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/file-items-service-4.3.5.jar
wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/file-server-4.3.5.jar

# bash file-items-service-4.3.5.jar --spring.profiles.active=db-h2 # or just:
bash file-items-service-4.3.5.jar
bash file-server-4.3.5.jar --app.upload.path=./path/to/file-storage

or simply shell script for h2

wget https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/application-h2.bash

# start
bash application-h2.bash start ./path/to/file-storage

# stop
bash application-h2.bash stop

# cleanup
bash application-h2.bash clean ./path/to/file-storage

for windows use https://github.com/daggerok/streaming-file-server/releases/download/4.3.5/application-h2.cmd

@rem start
application-h2.cmd start path\to\file-storage

@rem stop
application-h2.cmd stop

@rem cleanup
application-h2.cmd clean path\to\file-storage

note: tested on windows 10

installed binaries: which, del, wget, taskkill, mkdir and of course java, jps are required

development

gradle

./gradlew clean assemble postgresUp
./gradlew :m:a:f-i-s:bootRun
./gradlew :m:a:f-s:bootRun

# cleanup
./gradlew composeDown
./gradlew --stop

testing

awesome JGiven reports!

./gradlew clean test jgiven
open modules/apps/streaming-file-server/jgiven-reports/html/index.html

quick boot all with docker

./gradlew clean assemble allUp -Pdebug
http -a user:password :8002

run all in docker manually

./gradelw clean assemble
docker-compose -f ./modules/docker/all/docker-compose.yml up --build --force-recreate

cleanup and remove everything

NOTE: if you feel that changes take no effect, clean docker

# remove containers
for container in $(docker ps -qaf health=healthy) ; do docker rm -v -f $container ; done

# remove volumes
for volume in $(docker volume ls -q) ; do docker volume rm -f $volume ; done

# remove images
for image in $(docker images -qa) ; do docker rmi -f $image ; done

# or
docker system prune -af --volumes

publish release

./mvnw

todo

migrate from Mustache template engine to Thymeleaf
migrate from Bootstrap to Materialize.css
migrate ~~file-items-service and~~ file-server from mvc to reactive webflux
migrate from postgres to reactive postgres or R2DBC, or to some reactive NoSQL (mongodb, etc...)
add more advanced security, secure by MVC method...
improve files-db sync (replace FileSystem with GridFS or ...?)
backup, restore, migration...
support removing files (rly..? as minimum from db)
p2p, bi-directional files synchronization with spring scheduling or batch
gradle github release plugin (at the moment, for publishing releases to github is using maven. see pom.xml)

stack