1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/hotspot_ynh.git synced 2024-09-03 19:25:53 +02:00
hotspot_ynh/README.md
Julien VAUBOURG 651fde1d7e Update README
2015-05-05 20:13:12 +02:00

2 KiB

Wifi Hotspot

Overview

Warning: work in progress

Hotspot wifi app for YunoHost.

Broadcast your internet access (and your self-hosted web services) by wifi (see Friendly apps).

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

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
  • Web interface (screenshot)

Friendly apps

Some other YunoHost apps have this Hotspot wifi app as prerequisite, in order to offer a service through a wifi 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

This app works with a non-stable version of YunoHost.

Until this version is available (coming soon!) as an official stable release, you need to execute some commands before installing this app:

# service bind9 stop
# update-rc.d bind9 remove
# apt-get install dnsmasq