Uncle Blob

A ready to use and lightweight storage server built with love using Java. The name is pun and refference to uncle bob the author of The Clean Code book and the word blob just refferes to a Binary Large Object in the java script world.

Uncle Blob Server Docker Image

Uncle Blob Client Docker Image

Running Uncle Blob in docker compose

services:

  uncle-blob-server:

    container_name: uncle-blob-server
    image: ghcr.io/tadiwr/uncle-blob-server:latest

    networks:
      - net

    environment:
      - UNCLE_BLOB_STORAGE_DIR=/app/storage

    volumes:
      - storage_volume:/app/storage

    ports:
      - "8888:8888"

  uncle-blob-client:
    image: ghcr.io/tadiwr/uncle-blob-client:latest
    container_name: uncle-blob-client
    # build: ./uncle-blob-client

    networks:
      - net

    environment:
      - BACKEND_URL=http://uncle-blob-server:8888

    ports:
      - "3000:3000"


networks:
  net:

volumes:
  storage_volume:

The inspiration behind uncle blob was to avoid having to create storage server for every single project. Uncle blob is distributed as a docker image that you can easily pull and run on your machine with minimal configuration

Uncle blob also comes with a frontend ui made using Vue which allows you to visualise the files stored by the storage server. Here is a diagram to illustrate how it works

The server is made up of three layers:

• the storage layer resonsable for writing, reading and deleting files on the disk
• the service layer responsible for the business logic of handling file uploads, downloads, overwrites and deletions
• the api layer provides a rest api to allow clients to interact with the server