Changes for page FileSync

Last modified by Jan Brinkhaus on 2023/02/03 13:33

<
From version < 7.6 >
edited by Jan Brinkhaus
on 2023/02/03 12:12
To version < 2.1 >
edited by Jan Brinkhaus
on 2023/02/02 17:26
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,109 +1,62 @@
1 -= Prerequisite: Docker installation =
1 +Download token valid till ...
2 2  
3 -FileSync is deployed as docker container. You need a running docker installation for it to be installed. if you setup a new VM for this, we suggest the newest Ubuntu LTS release.
4 4  
5 -If you already have a server or VM with a running docker, just skip this chapter and go on with "Installation".
4 +sudo mkdir /var/docker_data
6 6  
7 -=== Install docker on linux ===
6 +cd /var/docker_data/
8 8  
9 -The installation of docker on linux is straightforward. If you Google this topic you will find explanations from the Docker website which invite you to do a manual installation of docker by downloading and installing their actual version. From a technical perspective this is not needed. At least Brinkhaus does not need bleeding edge docker installation. We recommend to just use the docker version which comes from your Linux distribution.
8 +sudo apt install docker docker-compose
10 10  
11 -On a typical Ubuntu or Debian you go with
12 -
13 -{{code language="Shell script"}}
14 -sudo apt install docker-compose
15 -{{/code}}
16 -
17 -=== Install docker on Windows ===
18 -
19 -The installation of docker for Windows is described here: [[https:~~/~~/docs.docker.com/desktop/install/windows-install/>>https://docs.docker.com/desktop/install/windows-install/]]
20 -
21 -= Installation =
22 -
23 -On a computer with Docker, just choose a target directory which fits for your case, deploy our docker-compose file there and start the app.
24 -
25 -**Suggestion for quick start for linux**
26 -
27 -{{code language="Shell script"}}
28 -sudo mkdir /var/docker_data
29 -cd /var/docker_data/
30 -wget https://xwiki.brinkhaus-gmbh.de/bin/download/Product%20support/FileSync/WebHome/docker-compose.yml?rev=1.1
31 31  sudo docker login registry.gitlab.com/v2/b3935 -u datastore-dl -p glpat-S9xzXzoUxuxGboW53r2x
32 32  
33 -sudo docker-compose up -d
34 -{{/code}}
12 +sudo docker-compose up
35 35  
36 -You are afterwards able to log in via the web interface on port 80 of the server where you installed FileSync.
14 +(% class="box" %)
15 +(((
16 +##version: "3"##
17 +)))
37 37  
38 -
39 -**Suggestion for quick start for Windows**
40 -
41 -Place the docker-compose file from here [[https:~~/~~/xwiki.brinkhaus-gmbh.de/bin/download/Product%20support/FileSync/WebHome/docker-compose.yml?rev=1.1>>https://xwiki.brinkhaus-gmbh.de/bin/download/Product%20support/FileSync/WebHome/docker-compose.yml?rev=1.1]] in a directory of your needs and run "docker-compose up -d".
42 -
43 -
44 -= Variants / hints =
45 -
46 -You can adapt the docker-compose file to your local needs. The file which we give for a quick start is:
47 -
48 -{{code language="docker-compose"}}
49 -version: "3"
50 -
51 -services:
52 - filesync:
53 - image: registry.gitlab.com/b3935/ftpmodule/filesync:latest
54 - container_name: filesync
55 - restart: always
56 - volumes:
57 - - ./data:/app/data
58 -
59 - ports:
60 - - 80:80
61 -
62 -{{/code}}
63 -
64 -This results in a password-less direct access to a UI on the target server.
65 -
66 -We below give an example for enclosing FileSync with Traefik as middleware for adding an easy authentification function:
67 -
68 -{{code language="docker-compose"}}
69 -version: "3"
70 -
71 -services:
19 +(% class="box" %)
20 +(((
21 +##services:
72 72   traefik:
73 - image: traefik:v2.2
23 + image~: traefik:v2.2
74 74   command:
75 - - "--providers.docker"
76 - - "--entrypoints.web.address=:80"
25 + - "~-~-providers.docker"
26 + - "~-~-entrypoints.web.address=:80"
77 77   ports:
78 78   - "80:80"
79 79   volumes:
80 80   - /var/run/docker.sock:/var/run/docker.sock
81 -# needed for using a dynamic password, settable from FileSync UI; links data/settings/ to the folder where
82 -# it is described in the "labels" of the filesync container
83 - - ./data:/var/docker_data/data
31 + - ./data:/var/docker_data/data##
32 +)))
84 84  
85 - filesync:
86 - image: registry.gitlab.com/b3935/ftpmodule/filesync:latest
34 +(% class="box" %)
35 +(((
36 +## filesync:
37 + image~: registry.gitlab.com/b3935/ftpmodule/filesync:latest
87 87   container_name: filesync
88 88   restart: always
89 89   volumes:
90 - - ./data:/app/data
41 + - ./data:/app/data##
42 +)))
91 91  
92 -# commented out because Traefik creates a protected rout for hisself
93 -# ports:
94 -# - 80:80
44 +(% class="box" %)
45 +(((
46 +###    ports:
47 +#      - 80:80##
48 +)))
95 95  
96 - labels:
50 +(% class="box" %)
51 +(((
52 +## labels:
97 97   - "traefik.http.routers.filesync.entrypoints=web"
98 98   - "traefik.http.routers.filesync.rule=Host(`datastore-playground.euprogigant.io`)"
99 99   - "traefik.http.routers.filesync.middlewares=auth"
100 100   - "traefik.http.services.filesync.loadbalancer.server.port=80"
101 -# hard coded password; hash retrievable via "htpasswd -bnBC 10 admin PASSWORD"
102 102   - "traefik.http.middlewares.auth.basicauth.users=admin:$$2y$$10$$2u0mbq4FI.EpN6Gu5O.BpO5Fh8RrXBr.MUT8JyqbYGtNfLn19OhTe" # credentials admin:changeme
103 -# dynamic password, settable from FileSync UI; needs link of data/settings/ in the docker container of Traefik
104 -# - "traefik.http.middlewares.auth.basicauth.usersfile=/var/docker_data/data/settings/hashedPW.txt"
58 +#      - "traefik.http.middlewares.auth.basicauth.usersfile=/var/docker_data/data/settings/hashedPW.txt"##
59 +)))
105 105  
106 -{{/code}}
107 107  
108 -
109 -
62 +
docker-compose.yml
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.brinkhaus
Size
... ... @@ -1,1 +1,0 @@
1 -236 bytes
Content
... ... @@ -1,15 +1,0 @@
1 -version: "3"
2 -
3 -services:
4 -
5 - filesync:
6 - image: registry.gitlab.com/b3935/ftpmodule/filesync:latest
7 - container_name: filesync
8 - restart: unless-stopped
9 -
10 - volumes:
11 - - ./data:/app/data
12 -
13 - ports:
14 - - 80:80
15 -

Need support?

If you need support feel free to contact:

Jan Brinkhaus: 0049 179 3939 733