Skip to content

A simple webgui to interface with Docker volumes as if they were in a file explorer. Keep in mind that this is still under 'alpha' development.

License

Notifications You must be signed in to change notification settings

digitalgenesiskompound/dve

Repository files navigation

dve-nobg

Docker Volume Explorer: A Simple Web-Based File Manager

Screenshot 2024-12-07 151859

Docker Volume Explorer (DVE) is a lightweight, Flask-based web application for managing files inside a Docker volume or any files from the host system that the Docker container is hosted on. It provides a user-friendly web interface to upload, delete, list, and download files.


Features

  • User Authentication: Secure login/logout and password management.
  • File Management: Upload, delete, download, add, or edit files and directories.
  • Text Editor: Edit text files in multiple different formats using a VSCode style editor.
  • Dockerized: Easy setup and deployment with Docker Compose.

Getting Started

Prerequisites


1. Clone the Repository

git clone https://github.com/digitalgenesiskompound/dve.git
cd dve

2. Configure the Environment

Copy the example .env file to customize settings:

cp .env.example .env

Edit the .env file to configure:

  • SECRET_KEY: A secure secret key for your application.

Command to create a random 32 character string:

openssl rand -hex 32
  • HOST_PATH: Directory on the host ("/home/user/mydirectory/forstuff") - OR - Set it as a name ("nas") and it will be contained in a Docker volume.

Example .env file:

SECRET_KEY=your_secret_key
HOST_PATH=/home/user/mydirectory/forstuff

3. Start the Application

Use Docker Compose to build and start the application:

docker compose up -d --build

4. Access the Application

Once the application is running, open your browser and navigate to:

http://localhost:5000

Login or register to start managing your files.


Stopping the Application

To stop the application run:

docker compose down

Screenshots

Screenshot 2024-12-07 152109 Screenshot 2024-12-07 151959 Screenshot 2024-12-07 151929 Screenshot 2024-12-07 151813

License

This project is licensed under the MIT License.

About

A simple webgui to interface with Docker volumes as if they were in a file explorer. Keep in mind that this is still under 'alpha' development.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published