fix docker and apache documentation

README.md

@@ -100,10 +100,21 @@ If you want your own dedicated instance but do not want to manage it by yourself
 
 ## Docker ##
 
-In case you prefer using Docker:
+**Important:** docker images is for local usage. If you want to use Tracim from network device, its necessary to change some lines in Development.ini file and build new image.
+
+
+* For windows:
+
+Install [docker toolbox](https://docs.docker.com/toolbox/toolbox_install_windows/)
+
+
+* For linux:
 
 You need to install docker on your server first.
+Example on Debian: `sudo apt-get install docker docker-compose`
+
 Make sure `docker.service` is started correctly.
+exemple on Debian: `sudo systemctl status docker`
 
 **If you want to use the latest stable image: **
 
@@ -119,22 +130,29 @@ Make sure `docker.service` is started correctly.
                -p 80:80 -p 3030:3030 -p 5232:5232 \
                -v /var/tracim/etc:/etc/tracim -v /var/tracim/var:/var/tracim algoo/tracim:<$tag>
 
+Description of versioning:
 
-* You can use `algoo/tracim:unstable` image:
-
-        sudo docker run -e DATABASE_TYPE=sqlite \
-               -p 80:80 -p 3030:3030 -p 5232:5232 \
-               -v /var/tracim/etc:/etc/tracim -v /var/tracim/var:/var/tracim algoo/tracim:unstable
+* algoo/`tracim:latest` is latest stable image from branch master
+* algoo/`tracim:<$tag>` is a stable tag image from branch master
+* algoo/`tracim_testing:latest` is a latest image from branch develop
+* algoo/`tracim:unstable` is a latest unstable image from branch develop
 
+More information about command:
 
-* You can use `algoo/tracim_testing:latest` image:
+    sudo docker run \
+        -e DATABASE_TYPE=sqlite \   # define database: may be sqlite, mysql, postgresql
+        -p 80:80 \  # web server port mapping
+        -p 3030:3030 \  # webdav interface port mapping
+        -p 5232:5232 \  # caldav interface port mapping
+        -v /var/tracim/etc:/etc/tracim \ # config file storage path
+        -v /var/tracim/var:/var/tracim \  # file storage path
+        algoo/tracim:unstable  # docker image: tracim:unstable for development version, tracim_test:latest for nightly builds
 
-        sudo docker run -e DATABASE_TYPE=sqlite \
-               -p 80:80 -p 3030:3030 -p 5232:5232 \
-               -v /var/tracim/etc:/etc/tracim -v /var/tracim/var:/var/tracim algoo/tracim_testing
 
 
 All docker images are available here : https://hub.docker.com/u/algoo/
+More information about build docker image: https://github.com/tracim/docker_tracim
+
 
 ----
 

doc/apache.md

@@ -2,45 +2,73 @@
 
 ### Installation ###
 
-Install `Apache` server and its [`WSGI` module](https://github.com/GrahamDumpleton/mod_wsgi):
+Install `tracim` first.
+Install `Apache` server and uwsgi  its [`WSGI` module](https://github.com/GrahamDumpleton/mod_wsgi):
 
-    sudo apt install apache2 libapache2-mod-wsgi-py3
+    sudo apt install apache2 libapache2-mod-wsgi-py3 uwsgi uwsgi-plugin-python3
 
 ### Configuration ###
 
 Create a file named `/etc/apache2/sites-available/tracim.conf` containing:
 
-    Listen 8080
+    Listen 80
 
-    <VirtualHost *:8080>
+    <VirtualHost *:80>
         ServerName tracim
 
-        # Serve Tracim through WSGI
-        WSGIDaemonProcess tracim user=[your_user] group=[your_user] threads=4 python-home=[tracim_path]/tg2env python-path=[tracim_path]/tracim lang='C.UTF-8' locale='C.UTF-8'
-        WSGIProcessGroup tracim
-        WSGIScriptAlias / [tracim_path]/tracim/app.wsgi process-group=tracim
-        <Directory "[tracim_path]/tracim">
-            <Files "app.wsgi">
-                Require all granted
-            </Files>
-        </Directory>
-
-        # Serve static files directly
-        Alias /assets          [tracim_path]/tracim/tracim/public/assets
-        Alias /_caldavzap      [tracim_path]/tracim/tracim/public/_caldavzap
-        Alias /favicon.ico     [tracim_path]/tracim/tracim/public/favicon.ico
-        <Directory "[tracim_path]/tracim/tracim/public">
-            Require all granted
-        </Directory>
+    <Directory "/">
+        Require all granted
+        Dav On
+    </Directory>
+    ProxyPreserveHost On 
+    CustomLog /var/log/apache2/algoo-access.log combined
+    ErrorLog /var/log/apache2/algoo-error.log
+    <Location "/webdav">
+        # Dav On
+    </Location>
+
+    # RemoteIPHeader X-Forwarded-For
+    ProxyPass /webdav http://127.0.0.1:3030/webdav
+    ProxyPassReverse /webdav http://127.0.0.1:3030/webdav
+    ProxyPass / http://127.0.0.1:8080/
+    ProxyPassReverse / http://127.0.0.1:8080/
+
     </VirtualHost>
 
-Replace `[tracim_path]` and `[your_user]` above by your tracim installation path and your user.
+Enable this configuration file:
+
+    sudo ln -s /etc/apache2/sites-available/tracim.conf /etc/apache2/sites-enabled/
+
+Check if you just have `tracim.conf` in `/etc/apache2/sites-enabled`, if not, remove other file.
+
+
+Create the file named `/etc/uwsgi/apps-available/tracim.ini` containing:
+
+    [uwsgi]
+    plugins = python3
+    chdir = [tracim_path]/tracim
+    home = [tracim_path]/tg2env
+    wsgi-file = app.wsgi
+    callable = application
+    http-socket = 0.0.0.0:8080
+    enable-threads = true
+    env = PYTHON_EGG_CACHE=/tmp
+
+Replace [tracim_path] by your path of tracim
 
-Set the `APP_CONFIG` variable of the `tracim/app.wsgi` file to match your tracim installation path:
+Enable this configuration file:
+
+    sudo ln -s /etc/uwsgi/apps-available/tracim.ini /etc/uwsgi/apps-enabled/
+
+
+Create file `tracim.log` in `/var/log/uwsgi/app/`
+
+Set the `APP_CONFIG` variable of the `[tracim_path]/tracim/app.wsgi` file to match your tracim installation path:
 
     # -*- coding: utf-8 -*-
 
-    APP_CONFIG = "[tracim_path]/tracim/development.ini"
+    APP_CONFIG = "[tracim_path]/tracim/development.ini" 
+    #(in file: replace /var/www/tracim by your [tracim_path] )
 
     #Setup logging
     # import logging
@@ -51,17 +79,82 @@ Set the `APP_CONFIG` variable of the `tracim/app.wsgi` file to match your tracim
     application = loadapp('config:%s' % APP_CONFIG)
     application.debug = False
 
+
+Add `webdav` at `root_path` in the `[tracim_path]/tracim/wsgidav.conf`:
+
+    ################################################################################
+    # Sample WsgiDAV configuration file
+    #
+    # 1. Rename this file to `wsgidav.conf`
+    # 2. Adjust settings as appropriate
+    # 3. Run tracim as you always do :)
+    #
+    ################################################################################
+    
+    ################################################################################
+    # SERVER OPTIONS
+    #===============================================================================
+    
+    # host  = "localhost"
+    # host  = "192.168.0.1"
+    host  = "0.0.0.0"
+    
+    port = 3030
+    
+    show_history = True
+    show_deleted = True
+    show_archived = True
+    
+    manager_locks = True
+    
+    root_path = ''
+    
+    #===============================================================================
+    # Lock Manager
+    #
+    # Example: Use PERSISTENT shelve based lock manager
+    #from wsgidav.lock_storage import LockStorageShelve
+    #locksmanager = LockStorageShelve("wsgidav-locks.shelve")
+
+
+
+Open `[tracim_path]/tracim/development.ini` and make some change:
+
+
+    In [server:main] modify IP:
+    `host = 127.0.0.1` by `host = 0.0.0.0`
+
+    For Radical (CalDav server):
+    Uncomment `# radicale.server.host = 0.0.0.0`
+    Uncomment `# radicale.server.allow_origin = *`
+    Uncomment `# radicale.client.base_url.host = http://127.0.0.1:5232`
+    and modifiy IP `# radicale.client.base_url.host = http://127.0.0.1:5232`to `radicale.client.base_url.host = http://[Your_server_IP]:5232`
+    
+    For WSGIDAV
+    Uncomment `# wsgidav.client.base_url = 127.0.0.1:<WSGIDAV_PORT>`
+    and modify IP and PORT `# wsgidav.client.base_url = 127.0.0.1:<WSGIDAV_PORT>` to `wsgidav.client.base_url = [Your_server_IP]/webdav`
+
+
+Restart `uwsgi` configuration:
+
+    sudo systemctl restart uwsgi.service
+
 Load needed proxy modules and enable this site configuration file:
 
-    sudo a2enmod proxy proxy_http
+    sudo a2enmod dav_fs dav proxy proxy_http
     sudo a2ensite tracim.conf
 
-Reload `Apache` configuration:
+Restart `Apache` configuration:
 
-    sudo systemctl reload apache2.service
+    sudo systemctl restart apache2.service
+    
+**Important**
+In case you have some permission problem, check if `www-data` can access to folder of tracim.
 
 ## Documentation Links ##
 
+[Apache]()
+
 [TurboGears](http://turbogears.readthedocs.io/en/tg2.3.7/cookbook/deploy/mod_wsgi.html)
 
 [mod_wsgi](http://modwsgi.readthedocs.io/en/develop/index.html)