You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
*[Installing the command line application](#installing-the-command-line-application)
16
+
*[Installing with docker-compose](#installing-with-docker-compose)
17
+
-[Running FileFighter](#running-filefighter)
18
+
*[Configuration](#configuration)
19
+
-[Updating](#updating)
20
+
*[Auto update](#auto-update)
21
+
-[Removing FileFighter](#removing-filefighter)
22
+
*[Remving the command line application](#remving-the-command-line-application)
23
+
*[Removing docker-compose version of FileFighter](#removing-docker-compose-version-of-filefighter)
24
+
-[Troubleshooting](#troubleshooting)
25
+
-[Remaining Files](#remaining-files)
26
+
-[Help](#help)
7
27
8
-
### Operating Systems
28
+
<small><i><ahref='http://ecotrust-canada.github.io/markdown-toc/'>Table of contents generated with markdown-toc</a></i></small>
9
29
10
-
Currently, we support only Unix-like operating systems like [Ubuntu](https://ubuntu.com). MacOs is still on our roadmap.
11
-
For windows systems you could use [wsl](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux). To set that up read more [here](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
30
+
# Requirements
12
31
13
-
### Dependencies
32
+
## Operating Systems
33
+
34
+
### Linux Distributions
35
+
36
+
We support all common Linux Distributions with `unzip`, `wget` and `curl`.
37
+
This code was tested under Linux Mint, Ubuntu 12, and Pop_!OS.
38
+
39
+
### macOS
40
+
41
+
Currently macOS is on our roadmap. You will still be able to run FileFigther with [docker-compose](https://docs.docker.com/compose/).
42
+
43
+
### Windows
44
+
45
+
Currently, we support only Unix-like operating systems like [Ubuntu](https://ubuntu.com).
46
+
For windows systems you could use [wsl](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux). To set that up read more [here](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
47
+
Alternativly you can use [docker-compose](https://docs.docker.com/compose/) to run the application.
48
+
49
+
## Dependencies
14
50
15
51
One of the of goals of FileFighter is, that the client, that's you, only needs to met one single dependency.
16
-
You need [Docker](https://www.docker.com/).
52
+
You need [Docker](https://www.docker.com/), or if you are using [docker-compose](https://docs.docker.com/compose/) you will need that too.
17
53
Docker is a way to organise and run multiple applications. You can imagine it like a virtual machine (technical it`s a bit different), with a small file- and operating system within your machine.
18
54
Sounds more scary than it actually is. Different Applications run in different containers, these only contain the necessary software to run the application.
19
55
The containers use the resources of the host machine, depending on the load.
20
-
Advantages are security and the possibility to easily shutdown and update the services. See more under "[Running FileFighter](#RunningFileFighter)".
56
+
Advantages are security and the possibility to easily shutdown and update the services. See more under [Running FileFighter](#Running-FileFighter).
21
57
22
-
####Docker
58
+
### Docker
23
59
24
60
First check whether you have Docker already installed.
25
61
To do that run:
@@ -34,29 +70,29 @@ If you see something like that (your version might be different):
34
70
Docker version 19.03.13, build 4484c46d9f
35
71
```
36
72
37
-
You are good to go, and you can skip to ["Installing FileFighter"](#InstallingFileFighter).
73
+
You are good to go, and you can skip to [Installing FileFighter](#Installing-FileFighter).
38
74
39
75
To install **Docker** on Unix you can either use [snap](https://www.howtogeek.com/660193/how-to-work-with-snap-packages-on-linux/) or [apt](<https://en.wikipedia.org/wiki/APT_(software)>) as a package manager.
40
76
With snap its easier but of course it's not always possible to use snap.
41
77
42
-
#####Install with Snap
78
+
#### Install with Snap
43
79
44
80
To install Docker with [snap](https://www.howtogeek.com/660193/how-to-work-with-snap-packages-on-linux/) you can run:
45
81
46
82
```shell script
47
83
sudo snap install docker
48
84
```
49
85
50
-
#####Install with Apt
86
+
#### Install with Apt
51
87
52
88
Installing with [apt](<https://en.wikipedia.org/wiki/APT_(software)>) is a bit more difficult you can read [here](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-Docker-on-ubuntu-20-04) more about it.
53
89
54
-
##Installing FileFighter
90
+
# Installing FileFighter
55
91
56
92
When your docker is ready to go you can install FileFighter.
57
-
You can install FileFighter as a commandline tool with many features, or if you are useing a non linux operating system like Windows or MacOs, with docker-compose.
93
+
You can install FileFighter as a commandline tool with many features, or if you are using a non linux operating system like Windows or MacOs, with docker-compose.
58
94
59
-
###Installing the command line application
95
+
## Installing the command line application
60
96
61
97
When you are running a linux distribution you can either use this command
or you can download the necessary scripts as a zipfile [here](https://github.com/FileFighter/ClientSetup/releases/).
68
104
You can ignore the docker-compose.zip and download the first zip.
69
105
It should be named like _FileFighter-v1.\*_
70
-
Unpack the zip file, navigate into the filder and you should see this README.md, and a _Install.sh_ script.
106
+
Unpack the zip file, navigate into the folder and you should see this README.md, and a _Install.sh_ script.
71
107
72
108
```shell script
73
109
dev@filefighter:~/Downloads/FileFighter-1.6 $ ls
@@ -118,7 +154,7 @@ usage: ffighter <args>
118
154
119
155
Running this command will add the FileFighter Application to your System.
120
156
121
-
### Installing with docker-compose
157
+
## Installing with docker-compose
122
158
123
159
Installing with docker-compose is very easy. First you need the command line tool [_docker-compose_](https://docs.docker.com/compose/install/) if it isn't already installed.
124
160
Then download the latest zipfile [here](https://github.com/FileFighter/ClientSetup/releases/).
@@ -141,7 +177,7 @@ docker-compose stop
141
177
Read more about _docker-compose_ [here](https://docs.docker.com/compose/).
142
178
<b>Note: All steps below are only for users of the command line application.</b>
143
179
144
-
## Running FileFighter
180
+
# Running FileFighter
145
181
146
182
You can use the FileFighter Application with the command _ffighter_
147
183
Running this command should show you something like that:
@@ -200,7 +236,7 @@ You should see a login page. For the first setup you can use the credentials.
200
236
`username=admin` and `password=admin`
201
237
To be sure everything is setup correctly click [here](http://localhost:80/health). If everything is green you are good to go.
202
238
203
-
### Configuration
239
+
## Configuration
204
240
205
241
The script uses a [config.cfg](config.cfg) file that stores information in `key=value` format.
206
242
Valid keys to configure how FileFighter behaves are listed here:
@@ -219,7 +255,7 @@ If the `db_password` key is empty, a random password will be generated.
219
255
220
256
Be carefully as the developers of FileFighter won't take responsibility when you are using the application or configuration options wrong or in a not intended way.
221
257
222
-
## Updating
258
+
# Updating
223
259
224
260
To update us the update command:
225
261
@@ -233,15 +269,15 @@ Depending on the configuration the update will either use the current stable ver
233
269
In case you are using the latest versions you will also need to install [regclient](https://github.com/regclient/regclient/releases).
234
270
Download the right version depending on your operating system and architecture, rename it to 'regctl', make it executable and move it to a folder that is in your path variable.
235
271
236
-
### Auto update
272
+
## Auto update
237
273
238
274
To achieve automatic updates you can set up a cron job as described in this [article](https://ostechnix.com/a-beginners-guide-to-cron-jobs/) with the update command.
239
275
240
276
This will also start all services and make them available [here](http://localhost:80/).
241
277
242
-
## Removing FileFighter
278
+
# Removing FileFighter
243
279
244
-
### Remving the command line application
280
+
## Remving the command line application
245
281
246
282
The application is installed under _/usr/bin/ffighter_.
<b>Be aware of the fact that the default location of uploaded files and folders will also be in this directory, and thus also deleted!</b>
260
296
261
-
### Removing docker-compose version of FileFighter
297
+
## Removing docker-compose version of FileFighter
262
298
263
299
Navigate to the location of the _docker-compose_ file and type:
264
300
@@ -268,14 +304,14 @@ docker-compose down
268
304
269
305
<small>Hint: This command wont remove the files uploaded.</small>
270
306
271
-
## Troubleshooting
307
+
# Troubleshooting
272
308
273
309
If you encounter error messages like _"No Permission"_ try giving you the permission to execute files for all scripts (/home/YOUR_USERNAME/filefighter).
274
310
275
-
## Remaining Files
311
+
# Remaining Files
276
312
277
313
All the remaining not explicitly explained files are important for the scripts to work and should not be changed manually.
278
314
279
-
## Help
315
+
# Help
280
316
281
317
For further help, feedback or questions write us an [email](mailto:[email protected]).
0 commit comments