/Pi-Hotspot-Script

Create a Wifi Hotspot on a Raspberry Pi

Primary LanguageShellOtherNOASSERTION

If you want something easier than a script, look at the dedicated distro that will build an up-to-date wifi hotspot. Look at this repository

What is Pi Hotspot

This project is the latest version of the tutorial created first on my blog Pi Home Server Created on a Raspberry Pi 2, some functionalities and tools where not available for the Raspberry Pi 3. Also the tutorial was a little bit difficult to implement because of too many steps. That's why i decided to create a script that will help you to build your own hotspot automatically.

Once the script is executed, you will get :

  • A Wifi hotspot using the integrated wifi chipset
  • A captive portal based on coovachilli
  • An authentication process based on freeRadius
  • An interface for freeRadius based on daloRadius

Requirements

What are the requirements ?

  • A Raspberry Pi 3
  • An ethernet cable
  • A power supply for the Raspberry Pi
  • A micro SD card with a raspbian-like OS installed. For this project i used minibian which is optimized for this project
  • An internet access of course
  • A micro SD card with a raspbian-like OS installed (recommanded one is minibian ). Supported OS are

WARNING : For this project i used minibian. No warranty that it will work with OSes like Official Raspbian, Ubuntu Mate Xenial, etc.

Usage

You just have to download the script, edit it to update it's parameters, execute and wait ... If the wifi on the Raspberry is not already configured, don't worry, the script will do it

  • Download the script with the following command
    git clone https://github.com/pihomeserver/Pi-Hotspot.git
  • Edit the script and update the first lines to define your own configuration (take care that an ethernet link is required)
  • Execute the script using the following command : sudo chmod +x pihotspot.sh && sudo ./pihotspot.sh

A log file named pihotspot.log will be created in the folder /var/log. Open a new session on the Pi and run the following command tail -f /var/log/pihotspot.log

Then

Once installed use your favorite browser to connect to daloRadius installed on your Raspberry Pi. http://<mypi_ip>/daloradius The exact address will be displayed at the end of the script execution. Do not try to connect to daloRadius throught your new hotspot network

Support

Please use input your requests or issues in the GIT repository

Any contribution is welcome !