From 7e9da522d5ad6d1420fab04f49b1f318e747e197 Mon Sep 17 00:00:00 2001 From: citronbleuv Date: Sat, 29 Jul 2017 21:29:07 +0200 Subject: [PATCH] dev initial next --- README.md | 104 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 54 insertions(+), 50 deletions(-) diff --git a/README.md b/README.md index d0da8d0..2bb18d3 100644 --- a/README.md +++ b/README.md @@ -1,62 +1,66 @@ keeweb-webdav ============== -WARNING / IN DEVELOPMENT !!! NO STABLE VERSION - -# Installation with Docker compose : - -``` -version: '2' -services: - webdav: - build: . - restart: always - ports: - - 80 - environment: - - WEBDAV_USERNAME=admin - - WEBDAV_PASSWORD=admin - - WEBDAV_BASEURI=/webdav - - BRUTEFORCE_PROTECTION_MAXRETRY=20 - volumes: - - webdav_files:/var/www/files - - webdav_www:/var/www - networks: - proxyweb: - ipv4_address: 172.240.1.14 - web: - image: viossat/keeweb - ports: - - 81:80 - volumes: - - web_www:/var/www/html - - web_log:/var/log/lighttpd -volumes: - webdav_files: - driver: local - webdav_www: - driver: local - web_www: - driver: local - web_log: - driver: local +This program is a manager password can be use in local and online. + +Technicaly, it's a combinaison of keeweb program to manage your passwords and Webdav (sabre/dav) to storage the password file. +Learn the keeweb documentation for more explication. + +## Features : + +### Security / Brute force protection + +Enabled by default, This protection block global web access an user try to connect at you + +## Quick start : + +### Requirements : + +1. [Docker](https://www.docker.com/community-edition#/download) version **1.12.0+** +2. [Docker Compose](https://docs.docker.com/compose/install/) version **1.9.0+** + +### Install last release + +Get the last stable release + +```bash +$ wget https://github.com/norticv/keeweb-webdav/archive/v1.0.0-alpha.zip keeweb-webdav.zip && unzip keeweb-webdav.zip ``` -# How to use ! +Install and run the program + +```bash +$ ./install +``` +Now you can open your web browser and go to http://localhost:8080 +Use the login "admin" and password "admin" to connect you. + +Is highly recommended to change the password. + +Warning, is recommended to use a reverse proxy with TLS if you want protected a public access ! + +## Configuration : + +WEBDAV_USERNAME : default admin, is webdav username using to authentication + +WEBDAV_PASSWORD : default admin, is webdav password using to authentication + +BRUTEFORCE_PROTECTION_MAXRETRY : default 10, block the access at the password page after 10 authentication try. + +## FAQ + +### How to use ! -Connect you to : http://localhost:81 -And upload your kdbx files +Connect you to : http://localhost:8080 -Go to http://localhost:80 to use Keeweb browser client. -Join your Webdav file. +### Where is the password storage file ? -Warning, is recommanded to use a reverse proxy with TLS if you want protected a public access ! +You can find the keepass file in files/general.kdbx -# Code license +### I want use my keepass file -You are free to use the code in this repository under the terms of the 0-clause BSD license. LICENSE contains a copy of this license. +You can replace your file in files/general.kdbx and it's ok -# Forked +### Where can I change the default keeweb configuration ? -Original maintainer Stephen Ausman -Forked from https://github.com/stackd/docker-sabre-dav +You can modify the file files/keeweb.config.json