YunoHost-Apps/hotspot_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/hotspot_ynh.git synced 2024-09-03 19:25:53 +02:00
Code Issues Activity Actions
hotspot_ynh/README.md
agentcobra 69571000d8
Merge branch 'master' into testing
2020-06-27 20:39:36 +02:00

3.2 KiB
Raw Blame History

Wi-Fi Hotspot

Build Status Integration level Install LaBriqueInterNet Hotspot with YunoHost

This package allows you to install DokuWiki quickly and simply on a YunoHost server.
If you don't have YunoHost, please see here to know how to install and enjoy it.

This YunoHost app is a part of the "La Brique Internet" project but can be used independently.

Overview

Hotspot Wi-Fi app for YunoHost.

  • Broadcast your own Wi-Fi internet access in addition to your self-hosted web services.
  • Without internet access, it's a PirateBox.
  • With the VPN Client app for YunoHost, it's an encrypted Wi-Fi internet access (eventually with neutral access, without filters, and with IPv6, depending on your VPN provider).

Screenshot

Screenshot of the web interface

Demo

Configuration

Documentation

YunoHost specific features

  • WPA2 encryption
  • 802.11n compliant
  • IPv6 compliant (with a delegated prefix)
  • Announce DNS resolvers (IPv6 with RDNSS/DHCPv6 and IPv4 with DHCPv4)
  • Automatic clients configuration (IPv6 with SLAAC/DHCPv6 and IPv4 with DHCPv4)
  • Set an IPv6 from your delegated prefix (prefix::42) on the server, to use for the AAAA records

Supported architectures

  • x86-64b - Build Status
  • ARMv8-A - Build Status
  • Jessie x86-64b - Build Status

Limitations

Additional information

Friendly apps

Some other YunoHost apps have this Hotspot Wi-Fi app as prerequisite, in order to offer a service through a Wi-Fi access point.

With a multissid wireless card (most can do that), you can create multiple access points.

For example, you can create 3 hotspots:

  1. PirateBox
  2. torNetwork
  3. neutralNetwork

You can then install and configure 3 other dependent apps on your YunoHost:

  1. PirateBox configured to use PirateBox,
  2. Tor Client configured to use torNetwork,
  3. VPN Client configured by default to use neutralNetwork because this hotspot is not used by another app in this case.

In this manner, with this example, you can provide 3 access points at the same time with 3 different services and only one wireless card.

Prerequisites

  • Debian Stretch
  • YunoHost >= 3.2.0