Skip to content

Commit

Permalink
Update instructions
Browse files Browse the repository at this point in the history
- Add minor fluxion instructions WIP
  • Loading branch information
deltax authored Aug 14, 2018
1 parent 7dad0ea commit d94992b
Showing 1 changed file with 31 additions and 23 deletions.
54 changes: 31 additions & 23 deletions misc/instructions.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,39 @@
### Fluxion instructions
Blackarch and arch strike already include this tool, kali doesn't. But you could try to fluxion with: `./fluxion`

#### Error codes
Fluxion exit with **1**:
**Reason: **Aborted, please execute the script as root.
**Solution:** `sudo ./fluxion`
#### Step 1: Cloning the git repository
`git clone https://github.com/FluxionNetwork/fluxion`

Fluxion exit with **2**:
**Reason: **Aborted, X (graphical) session unavailable.
**Solution:** Run fluxion in a grafical session

Fluxion exit with **3**:
**Reason: **Aborted, xdpyinfo is unavailable.
**Solution:** Depend on your package manager
#### Step 2: Execute fluxion
Just navigate to the fluxion directory or the directory containing the scripts in case you downloaded them manually. If you are following the terminal commands I'm using, then it's just a simple change directory command for you. After you can execute the script.
```
apt-get install xdpyinfo # for debian and kali
pacman -S xdpyinfo # for arch
yum install xdpyinfo # for gentoo
cd fluxion
./fluxion -i
```

Fluxion exit with **4**:
**Reason: **Aborted, xterm test session failed.
**Solution:** Run fluxion in a grafical session
Your unmet dependencies will be resolved, and then you can use fluxion.<br>
**Note** You can try parameter `-i` which allows fluxion, auto install dependencies.

#### Step 3: Select language
Make sure your select the right language. Fluxion does support over 10+ languages. If there are any spelling errors, let us know or submit a pull request.

#### Step 4: Select interface
Select a prober interface make sure that it support AP mode and master mode. Both are required for fluxion. You can check both if you run the diagnostic script, located inside the scripts folder. You only has to do as root `./diagnostic [interface]`.

#### Step 5: Gather handshake
In order to make sure that fluxion can check if there is a valid password you have to make sure that you gather handshake first. Run the handshake snooper attack first. Select and deauth option and a delay.

#### Step 6: Start ap mode
Now, after gathering the handshake you can run the AP. Select the ssl option and your favorite login site. Generic sites and custom router sites are supported. You can also use your own by running the router.sh script.

Fluxion exit with **5**:
**Reason: **Aborted, enhanced getopt isn't available.
**Solution:** Depend on your package manager
#### Exit codes
**Check exit code with:** `echo $?`

Fluxion exit with **6**:
**Reason: **Aborted, can't generate a workspace directory.
**Solution:** Make sure you have some diskspace left
| Exit codes | Reason | Solution |
| :--: |---|---|
| **1** | Aborted, please execute the script as root. | `sudo ./fluxion` |
| **2** | Aborted, X (graphical) session unavailable. | Run fluxion in a grafical session |
| **3** | Aborted, xdpyinfo is unavailable. | ```apt-get install xdpyinfo``` |
| **4** | Aborted, xterm test session failed. | Run fluxion in a grafical session |
| **5** | Aborted, enhanced getopt isn't available. | Depend on your package manager |
| **6** | Aborted, can't generate a workspace directory. | Make sure you have some diskspace left |

0 comments on commit d94992b

Please sign in to comment.