You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
LabyrinthAP/README.md

133 lines
6.5 KiB
Markdown

5 years ago
![](https://i.imgur.com/mXuacOH.jpg)
4 years ago
# `$ Lokiap-webgui` [![Release 2.1](https://img.shields.io/badge/Release-2.1-green.svg)](https://github.com/necro-nemesis/raspap-webgui/releases)
6 years ago
LokiAP interfaces witht Lokinet daemon to facilitate connections to the Lokinet global privacy network. LokiAP provides a simple, responsive web interface to control wifi, hostapd, Lokinet daemon and related services necessary to access Lokinet on the Raspberry Pi or Orange Pi.
9 years ago
5 years ago
### WHAT IS LOKI?
9 years ago
5 years ago
https://loki.network/
"Loki is a privacy network which will allow users to transact and communicate privately over the internet, providing a suite of tools to help maintain the maximum amount of anonymity possible while browsing, transacting and communication online. Using the decentralised nature of blockchain technology, Loki creates new private and secure methods of interacting with the internet, as well as building privacy-centric applications, such as messaging services, forums, online marketplaces, and social media platforms."
5 years ago
Loki
5 years ago
5 years ago
![](https://i.imgur.com/fxKF4bi.jpg)
5 years ago
4 years ago
![](https://i.imgur.com/A5rv8Rw.png)
4 years ago
5 years ago
![](https://i.imgur.com/F83n7PF.jpg)
5 years ago
9 years ago
## Contents
9 years ago
- [Prerequisites](#prerequisites)
4 years ago
- [Preparing the image](#preparing-the-image)
- [Accessing the device](#accessing-the-device)
- [Quick installer](#quick-installer)
5 years ago
- [Test Site](#test-site)
4 years ago
- [Connecting to an Exit Node](#connecting-to-an-exit-node)
5 years ago
- [Support us](#support-us)
9 years ago
- [How to contribute](#how-to-contribute)
9 years ago
- [License](#license)
9 years ago
9 years ago
## Prerequisites
Start with a clean install of [Armbian](https://www.armbian.com/) or [Raspberry Pi OS](https://www.raspberrypi.org/downloads/raspberry-pi-os/) (currently Buster and Stretch are verified as working). Lite versions are recommended as all additional dependencies are added by the installer. If using Raspberry Pi OS you will need to elevate to root with ```sudo su``` before running the LokiAP installer script. This additional step is not required when using Armbian.
4 years ago
For Orange Pi R1 use Armbian Buster found here: https://www.armbian.com/orange-pi-r1/. Recommend using "minimal" which is available for direct download at the bottom of the page or much faster download by .torrent also linked there.
Specific code has been incorporated to take advantage of the OrangePi R1's second ethernet interface. The AP will provide access via ethernet in addition to wifi when using this board.
4 years ago
For OrangePi Zero use Armbian Buster found here": https://www.armbian.com/orange-pi-zero/
Note:
Although it will function the OrangePi Zero has a well documented issue with the XR819 wifi chip used on this board. It will drop connections occasionally as a result of unresolved firmware issues. The board is supported but I would recommend using the R1 over the Zero given it has two ethernet adapters and is equipped with a Realtek wifi chip which is stable.
5 years ago
To burn the image to an SD card on your PC you can use Etcher:
https://www.balena.io/etcher/
5 years ago
## Preparing the image
5 years ago
For Raspberry Pi OS you will need to remove the SD card from the computer, reinsert it, open the boot directory up and create a new textfile file named `ssh` with no .txt file extension i.e. just `ssh` in order to remotely connect. This step is not required for Armbian.
Insert the SD card into the device and power it up.
5 years ago
## Accessing the device
5 years ago
Obtain a copy of Putty and install it on your PC:
https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
5 years ago
1. Log into your router from your PC and find the address it assigned to the Pi.
5 years ago
2. Start Putty up and enter this obtained address into Putty with settings:
5 years ago
Host Name Address = the address obtained from router | Port `22` | connection type `SSH` | then `OPEN`
For Raspberry Pi OS the default login is `pi` password `raspberry`
5 years ago
For Armbian the default login is `root` password `1234`
5 years ago
3. Follow any first user password instructions provided once logged in.
4. If you want to get the lastest updates before installing LokiAP:
```
sudo apt-get update
sudo apt-get upgrade
sudo reboot
```
5. If you have an older Raspberry Pi without an onboard WiFi chipset, the [**Edimax Wireless 802.11b/g/n nano USB adapter**](https://www.edimax.com/edimax/merchandise/merchandise_detail/data/edimax/global/wireless_adapters_n150/ew-7811un) is an excellent option it's small, cheap and has good driver support.
9 years ago
With the prerequisites done, you can now proceed with the Quick installer.
9 years ago
## Quick installer
Install LokiAP from shell prompt:
```sh
5 years ago
$ wget -q https://git.io/fjeSw -O /tmp/raspap && bash /tmp/raspap
```
The installer will complete the installation steps for you. You will be occasionally prompted to answer `y` or `n`. Answering yes to all prompts will in almost all cases be the answer you want so if in doubt respond with `y` that you want the default set up and the AP will work.
After the reboot at the end of the installation the wireless network will be
configured as an access point as follows:
4 years ago
* AP GUI address: loki.ap.local or use IP address: 10.3.141.1
5 years ago
* Username: `admin`
* Password: `secret`
* DHCP range: 10.3.141.1 to 10.3.141.24
5 years ago
* SSID: `loki-access`
5 years ago
* Password: `ChangeMe`
## Test site
To test the connection navigate to Loki's wiki page found at
4 years ago
http://dw68y1xhptqbhcm5s8aaaip6dbopykagig5q5u1za4c7pzxto77y.loki/wiki/index.php?title=Main_Page
## Connecting to an Exit Node
4 years ago
Exit nodes provide privacy on the internet through onion routing connections via the global network of Lokinet relay nodes and dedicated exit nodes. In order to connect to an exit node you will require the exit address from the exit node provider. These can be found through various social media linked at https://loki.network/. From the GUI this information can be entered and activated.
5 years ago
## Support us
4 years ago
LokiAP is free software but powered by your support. If you find it beneficial or wish to contribute to inspire ongoing development small donations are greatly appreciated.
5 years ago
4 years ago
- Loki Donation Address:
```sh
5 years ago
LA8VDcoJgiv2bSiVqyaT6hJ67LXbnQGpf9Uk3zh9ikUKPJUWeYbgsd9gxQ5ptM2hQNSsCaRETQ3GM9FLDe7BGqcm4ve69bh
```
4 years ago
- PayPal Donation Address:
4 years ago
4 years ago
![](https://i.imgur.com/gIhGB1X.jpg)
4 years ago
9 years ago
## How to contribute
1. File an issue in the repository, using the bug tracker, describing the
contribution you'd like to make. This will help us to get you started on the
right foot.
2. Fork the project in your account and create a new branch:
`your-great-feature`.
3. Commit your changes in that branch.
4. Open a pull request, and reference the initial issue in the pull request
message.
## License
8 years ago
See the [LICENSE](./LICENSE) file.