A lightweight, self-hosted file storage solution with samba/smb support powered by Docker.

About   |   Features   |   Technologies   |   Requirements   |   Installation   |   Author

---

About

A simple file storage app that runs with Docker. You can save, organize, and manage your files quickly using a clean and modern web interface. It’s easy to set up and use, so you can focus on your files instead of worrying about complicated tools.

---

Features

• Fast and lightweight
• File upload & management
• Secure authentication
• Modern Design
• Super easy to set up
• Supports file sharing to multiple platforms like discord

---

Technologies

The following tools were used in this project:

• Python
• Flask
• Jinja2
• Html
• CSS
• JavaScript
• JSON

---

Requirements

Before starting with the docker version, you need to have Docker installed.

Before starting with the local version, you need to have Python installed

Installation

1. Clone the project

git clone https://github.com/JesseHoekema/BubbleCloud

2. Cd into the project directory

cd BubbleCloud

4. In the docker compose file set the samba username and password like this

- USER=username;password

3. Run Docker Compose Command (make sure docker is running)

docker compose up --build -d

4. Now the webUI is running on port: 5923 (Unless you changed it)

---

Optional Things

1. Changing the webUI port

Open the docker-compose and edit the ports, then open the Dockerfile and edit the gunicorn command to match your port

2. Syncing the files with a directory outside of the docker container

Open the docker-compose.yml file and remove the #'s:

With #'s:

# volumes:
#  - ./YOUR_DIR_OUTSIDE_OF_CONTAINER:/app/app-files/files

Without #'s:

volumes:
  - ./YOUR_DIR_OUTSIDE_OF_CONTAINER:/app/app-files/files

After that replace the: YOUR_DIR_OUTSIDE_OF_CONTAINER With your directory path in your server

3. To run local run: ./local.sh for Mac and ./local.bat for Windows