From 6682a207b2eff50b08d2ae2224cf81717dbcfa1c Mon Sep 17 00:00:00 2001 From: Giandonato Inverso <70962472+giandonatoinverso@users.noreply.github.com> Date: Mon, 16 Oct 2023 22:24:15 +0200 Subject: [PATCH] updated documentation --- README.md | 10 ++++++++++ docker/README.md | 30 ------------------------------ 2 files changed, 10 insertions(+), 30 deletions(-) delete mode 100644 docker/README.md diff --git a/README.md b/README.md index 49eb14c..c7ab286 100644 --- a/README.md +++ b/README.md @@ -55,6 +55,16 @@ - CSS files - Docker compose file +## Setup with docker compose (simplest method) +1. download docker-compose.yml file +2. Start docker stack +```bash +docker compose build --no-cache && docker compose up -d +``` +3. Open your browser at http://localhost:80 and login with (username: superadmin, password: superadmin) + +For other setup methods please see the documentation + ## Changelog - Version 1.0 – September, 2020 (Initial release) diff --git a/docker/README.md b/docker/README.md deleted file mode 100644 index 7bbecc4..0000000 --- a/docker/README.md +++ /dev/null @@ -1,30 +0,0 @@ -### How to run this image - -- currently this image must be build locally.(in future can be pulled from docker hub) -- create folder to mount inside docker container - - `mkdir -p ./data/mariadb ./data/app/config ./data/app/saved_qrcode` -- Run and build this image as host machine user - - `PUID="$(id -u)" PGID="$(id -g)" docker-compose up --build -d` -- Run and build this image as specific user - - `PUID="1000" PGID="1000" docker-compose up --build -d` -- Run app installation :8080/install - - Provide Database credentials -- Default login: :8080 - - user: superadmin - - password: superadmin - -### Roadmap - -- Make install process run via docker-compose. - - Work is partially done. docker-entrypoint.sh is created.(currently disabled due to next steps are pending) - - qrcode/install/database.php should be adjusted to create database without form submission. -- Make it possible to set PUID and GUID, from environment variable in docker-compose.yml . -- Reduce image size by removing unnecessary dependencies. -- Automate Build image and push to docker hub. -- Audit security flaws and fix it if needed. - -### Some debug commands - -- `docker-compose logs` -- `PUID="$(id -u)" PGID="$(id -g)" docker-compose config` -- `ps -aef | grep apache2` \ No newline at end of file