-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
1facf1e
commit 7e9da52
Showing
1 changed file
with
54 additions
and
50 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 <[email protected]> | ||
Forked from https://github.com/stackd/docker-sabre-dav | ||
You can modify the file files/keeweb.config.json |