Skip to content

Commit 04c56a4

Browse files
authored
Added toc and cleanup (#15)
* Fixed Links * Added TOC * Typo, and docker-compose support. * Added dedicated os support.
1 parent 3015b61 commit 04c56a4

File tree

1 file changed

+63
-27
lines changed

1 file changed

+63
-27
lines changed

README.md

Lines changed: 63 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,61 @@
11
# FileFighter Setup
22

3-
Setup Scripts for clients to download.
3+
Setup Scripts for clients to install FileFighter.
44
![Release](https://img.shields.io/github/v/release/filefighter/clientsetup?color=dark-green&label=Latest%20Version&logo=github&style=for-the-badge)
55

6-
## Requirements
6+
**Table of Contents**
7+
- [Requirements](#requirements)
8+
* [Operating Systems](#operating-systems)
9+
+ [Linux Distributions](#linux-distributions)
10+
+ [mac OS](#mac-os)
11+
+ [Windows](#windows)
12+
* [Dependencies](#dependencies)
13+
+ [Docker](#docker)
14+
- [Installing FileFighter](#installing-filefighter)
15+
* [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)
727

8-
### Operating Systems
28+
<small><i><a href='http://ecotrust-canada.github.io/markdown-toc/'>Table of contents generated with markdown-toc</a></i></small>
929

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
1231

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
1450

1551
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.
1753
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.
1854
Sounds more scary than it actually is. Different Applications run in different containers, these only contain the necessary software to run the application.
1955
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](#Running FileFighter)".
56+
Advantages are security and the possibility to easily shutdown and update the services. See more under [Running FileFighter](#Running-FileFighter).
2157

22-
#### Docker
58+
### Docker
2359

2460
First check whether you have Docker already installed.
2561
To do that run:
@@ -34,29 +70,29 @@ If you see something like that (your version might be different):
3470
Docker version 19.03.13, build 4484c46d9f
3571
```
3672

37-
You are good to go, and you can skip to ["Installing FileFighter"](#Installing FileFighter).
73+
You are good to go, and you can skip to [Installing FileFighter](#Installing-FileFighter).
3874

3975
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.
4076
With snap its easier but of course it's not always possible to use snap.
4177

42-
##### Install with Snap
78+
#### Install with Snap
4379

4480
To install Docker with [snap](https://www.howtogeek.com/660193/how-to-work-with-snap-packages-on-linux/) you can run:
4581

4682
```shell script
4783
sudo snap install docker
4884
```
4985

50-
##### Install with Apt
86+
#### Install with Apt
5187

5288
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.
5389

54-
## Installing FileFighter
90+
# Installing FileFighter
5591

5692
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.
5894

59-
### Installing the command line application
95+
## Installing the command line application
6096

6197
When you are running a linux distribution you can either use this command
6298

@@ -67,7 +103,7 @@ curl https://raw.githubusercontent.com/FileFighter/ClientSetup/master/Download.s
67103
or you can download the necessary scripts as a zipfile [here](https://github.com/FileFighter/ClientSetup/releases/).
68104
You can ignore the docker-compose.zip and download the first zip.
69105
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.
71107

72108
```shell script
73109
dev@filefighter:~/Downloads/FileFighter-1.6 $ ls
@@ -118,7 +154,7 @@ usage: ffighter <args>
118154
119155
Running this command will add the FileFighter Application to your System.
120156
121-
### Installing with docker-compose
157+
## Installing with docker-compose
122158
123159
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.
124160
Then download the latest zipfile [here](https://github.com/FileFighter/ClientSetup/releases/).
@@ -141,7 +177,7 @@ docker-compose stop
141177
Read more about _docker-compose_ [here](https://docs.docker.com/compose/).
142178
<b>Note: All steps below are only for users of the command line application.</b>
143179
144-
## Running FileFighter
180+
# Running FileFighter
145181
146182
You can use the FileFighter Application with the command _ffighter_
147183
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.
200236
`username=admin` and `password=admin`
201237
To be sure everything is setup correctly click [here](http://localhost:80/health). If everything is green you are good to go.
202238
203-
### Configuration
239+
## Configuration
204240
205241
The script uses a [config.cfg](config.cfg) file that stores information in `key=value` format.
206242
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.
219255
220256
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.
221257
222-
## Updating
258+
# Updating
223259
224260
To update us the update command:
225261
@@ -233,15 +269,15 @@ Depending on the configuration the update will either use the current stable ver
233269
In case you are using the latest versions you will also need to install [regclient](https://github.com/regclient/regclient/releases).
234270
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.
235271
236-
### Auto update
272+
## Auto update
237273
238274
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.
239275
240276
This will also start all services and make them available [here](http://localhost:80/).
241277
242-
## Removing FileFighter
278+
# Removing FileFighter
243279
244-
### Remving the command line application
280+
## Remving the command line application
245281
246282
The application is installed under _/usr/bin/ffighter_.
247283
Remove it by typing:
@@ -258,7 +294,7 @@ rm-rf /home/YOUR_USERNAME/filefighter
258294
259295
<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>
260296
261-
### Removing docker-compose version of FileFighter
297+
## Removing docker-compose version of FileFighter
262298
263299
Navigate to the location of the _docker-compose_ file and type:
264300
@@ -268,14 +304,14 @@ docker-compose down
268304
269305
<small>Hint: This command wont remove the files uploaded.</small>
270306
271-
## Troubleshooting
307+
# Troubleshooting
272308
273309
If you encounter error messages like _"No Permission"_ try giving you the permission to execute files for all scripts (/home/YOUR_USERNAME/filefighter).
274310
275-
## Remaining Files
311+
# Remaining Files
276312
277313
All the remaining not explicitly explained files are important for the scripts to work and should not be changed manually.
278314
279-
## Help
315+
# Help
280316
281317
For further help, feedback or questions write us an [email](mailto:[email protected]).

0 commit comments

Comments
 (0)