Grase Hotspot

V4 Alpha Builds

V4 Alpha Builds

These are instructions for the currently V4 nightly builds to get up and running to help test V4.

  1. Clean install Ubuntu 18.04 server (please don’t install desktop components unless you know how to disable systemd-resolved and other networking components that get in the way)

  2. During the install, you will need to configure your network cards. Only configure your WAN interface, leave your LAN interface unconfigured.

  3. Setup the Grase development APT repository

    echo deb https://apt.grasehotspot.org/dev bionic main | sudo tee /etc/apt/sources.list.d/grase.list
  4. Add the APT repo key

    sudo wget https://github.com/GraseHotspot/grase-repo/raw/master/key/grase.hotspot.2020.gpg -O /etc/apt/trusted.gpg.d/grase.hotspot.2020.gpg
  5. Update APT database

    sudo apt update
  6. Install the required Grase packages. As part of the install there are a few database questions, you can just accept the defaults

    sudo apt install grase-www-portal
    sudo apt install grase-conf-freeradius grase-conf-dnsmasq coova-chilli
  7. Run the first-run wizard, this will ask questions to setup the network, and the admin password

    sudo -u www-data /usr/share/grase/symfony4/bin/console grase:first-run
  8. Reboot

  9. The Grase system should now be up and running, you should be able to access the admin interface from either the LAN or WAN interface, by going to http://<IP ADDRESS>/grase (replacing <IP ADDRESS> with the correct ip address for the LAN/WAN interface). Username is admin and you set the password in the first run wizard.

V3 to V4 Migration

If you wish to test the migration from V3, you need to get your latest database backups (located in /var/backups/grase) there will be a mysql_radius backup and a mysql_radmin backup file. You can then use the following command to load the V3 backup into your V4 server. This will delete the entire database on the server, load the V3 database, migrate into the V4 structure. You will then need to run the first-run wizard from above again.

sudo -u www-data /usr/share/grase/symfony4/bin/console grase:migrate-v3-backup mysql_radius_backup.sql mysql_radmin_backup.sql
Edit this page on GitHub

On this page