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

114 lines
5.0 KiB
Markdown

5 years ago
![](https://i.imgur.com/mXuacOH.jpg)
5 years ago
# `$ Lokiap-webgui` [![Release 1.7](https://img.shields.io/badge/Release-1.7-green.svg)](https://github.com/necro-nemesis/raspap-webgui/releases)
6 years ago
LokiAP interfaces witht Lokinet daemon to facilitate connections to the 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
![](https://i.imgur.com/V9coVgA.jpg)
This project branches from the work of Raspap and SB Admin 2.
9 years ago
![](https://i.imgur.com/qdXbAGn.png)
5 years ago
9 years ago
## Contents
9 years ago
- [Prerequisites](#prerequisites)
- [Quick installer](#quick-installer)
5 years ago
- [Support us](#support-us)
- [Manual installation](#manual-installation)
- [Multilingual support](#multilingual-support)
9 years ago
- [Optional services](#optional-services)
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 the [latest release of Raspbian](https://www.raspberrypi.org/downloads/raspbian/) (currently Stretch). Raspbian Stretch Lite is recommended.
9 years ago
For Orange Pi Zero use Armbian Stretch found here: https://dl.armbian.com/orangepizero/
For Orange Pi R1 use Armbian Stretch found here: https://dl.armbian.com/orangepi-r1/
Burn the image to an SD card on your PC using Etcher:
https://www.balena.io/etcher/
5 years ago
## Preparing the image
5 years ago
5 years ago
For Raspbian 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:
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`
5 years ago
For Raspbian the default login is `root` password `raspberry`
For Armbian the default login is `root` password `1234`
5 years ago
3. Follow any first user password instructions provided once logged in.
5 years ago
4. Update Raspbian/Armbian, including the kernel and firmware, followed by a reboot:
```
sudo apt-get update
sudo apt-get dist-upgrade
sudo reboot
```
5 years ago
5. Set the WiFi country in raspi-config's / armbian-config's **Localisation Options**: `sudo raspi-config` or `sudo arbmian-config` for RasperryPi or OrangePi respectively.
9 years ago
5 years ago
6. 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 proceed with either the Quick installer or Manual installation steps below.
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
```
5 years ago
The installer will complete the steps in the manual installation (below) 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:
* 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`
5 years ago
## Support us
5 years ago
LokiAP is free software, but powered by your support. If you find it beneficial or wish to contribute to inspire ongoing development your donations of any amount; be they even symbolic, are a show of approval and are greatly appreciated.
5 years ago
Loki Donation Address:
```sh
5 years ago
LA8VDcoJgiv2bSiVqyaT6hJ67LXbnQGpf9Uk3zh9ikUKPJUWeYbgsd9gxQ5ptM2hQNSsCaRETQ3GM9FLDe7BGqcm4ve69bh
```
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.