GRASE Hotspot
Basic install instructions
To be improved on
Install Ubuntu Server to computer. UbuntuServerInstallation
If you didn’t follow the Ubuntu Server install instructions, or have installed a GUI, please check the Hardware Setup page for some important information about the network card setup.
When it boots you will be presented with a prompt. Login with the username and password you set. Download latest grase-repo package from http://packages.grasehotspot.org/pool/main/g/grase-repo/
e.g. (Update to point to the latest grase-repo package at the above link)
$ wget http://packages.grasehotspot.org/pool/main/g/grase-repo/grase-repo_1.3_all.deb
install the package
$ sudo dpkg -i grase-repo_1.3_all.deb
Update the repository
$ sudo apt-get update
Then install the components. Currently for a full system, the following command should suffice
$ sudo apt-get install grase-www-portal grase-conf-freeradius grase-conf-squid3 grase-conf-openvpn
This will proceed to download all the dependencies as well and install them. It will ask a few questions which are needed to finish setting it up. See the below sections for answering these questions
Finally, if you have a support contract for full remote assistance, then install the remote assistance part. (Certain organisations currently get this, if in doubt please contact me first)
$ sudo apt-get install grase-remote-assist-user
Configuring grase-conf-freeradius
Attempting to setup the database manually is possible but should not be attempted without good reason.
- When it asks you if you want to use dbconfig-common to manage it, please answer yes.
- You will then need to enter the MySQL root users password which was set during the Ubuntu Server install. If you didn’t select LAMP when installing Ubuntu Server, before you get to this question it will install MySQL and ask you to set a password.
- It will then ask you for and “MySQL application password for grase-conf-freeradius. You can leave this blank and a random password will be created. If you are going to want/need to poke around in the user database userself with SQL commands, then set this password to something you know.
Configuring grase-www-portal
See the above section for grase-conf-freeradius, all of that applies for this, it’s just for the database for the web interface (mostly admin users and logs)
Install finished
This should have installed the base system, and submit the systems key to a central server for remote admin. (But not the remote admin user setup, that will have to come later at this stage).
You should now be able to access the web interface at http://10.1.0.1/grase/radmin (from the LAN side). The LAN side is the network interface you are running your WiFi Access Point off.
Default username is admin and password is hotspotadmin
Please post support requests to the mailing list, and not as comments below. This way the whole community can assist with answering your questions
50 Responses to Installation
Leave a Reply
Consider a donation to assist with development costs
[...] met, and the configurations for all the pieces of required software is automatic. Please read the installation instructions before [...]
Mate great work
Is there a way to geto the gui from the wan side
cheers
looking forward to updates
Easiest way is to port forward port 80 to your hotspot machine (you can port forward an alternative port like 5678 as long as it points to 80 on the hotspot machine). Just make sure you secure the server to allow access from limited ip addresses.
Thanks mate
just had a look where is the script located
i am running 11.04 and just found out its changed a bit from 10.10
cheers
Your Hotspot works like a charm
I thank you so much for all your work.
Definitely Greater than all the other free hotspot !
You’re amazing
Seb
I agree
the installation, don’t work.
I can’t install on ubuntu server 10.04
this command don’t work
sudo apt-get install grase-www-portal grase-conf-freeradius grase-conf-squid3 grase-conf-openvpn
have any idea?
Thanks
I to all,
with ubuntu server 11.04 it’s work but i think that we have some problem with dns.
Had a problem with installing as the Ubuntu 10.04 server squid version was not high enough, was generating an error with the version
I found squid3 3.1.6 available on the following website, which solved my installation problems
https://launchpad.net/~ubuntu-backports-testers/+archive/ppa/+build/1981799
Good Morning All i got this error msg while configuring Grase HotSpot………
Any HELP please…..
Thanks
* Stopping virtual private network daemon(s)… * Stopping VPN ‘grase’: No such VPN is running.
* Starting virtual private network daemon(s)…
* Starting VPN’grase’ [fail]
invoke-rc.d: initscript openvpn, action “restart” failed.
Setting up grase-www-portal (3.3) …
This message is normal for the grase-conf-openvpn package. Until the VPN certificate is approved by the central server, the VPN can’t start. The install is fine.
Thanks Tim for the Response…
I will get the community on my success thanks…
Willing to help on Translation
Tim, please for how long will i have to wait for the server to approve it?
Thanks in advance..
Hello, I installed the latest version of fat hotspot on ubuntu 11.04. but from the PC client is not possible to go on the internet. in fact, I have not even the captive portal. someone could help me?
Hi Fabrice.
Please post all support requests to the mailing list. We’ll need you to run different commands to try and diagnose where the problem is.
Thanks
Tim
works great!
we’re configuring the login screen.
i personally donate you!
hi,
i cant integrate the conection with a dansguardian, to filter what can users use?
im sorry.
this is my question:
could i integrate Dansguardian on the same server?
Hi Mena.
It is possible to run Dansguardian on the same server, I’ve just not written any instructions for it yet. Please consider posting to the mailing list as someone else may have already set it up.
Tim
thanks
Hola, es factible realizar control de acceso a sitios web con grasehotspot? Puedo modificar el archivo squid.conf para agregar las acl?
Excelente herramienta grasehotspot.
Saludos.
Hi Manuel.
Yes, you can use squid to control access. Please post support requests to the mailing list, preferably in English.
Hello Tim, i have seen that in squid directory there are 2 files squid.conf and squid.conf.grase which of these files is using grasehotspot?
Also i don’t see in the acl the network 10.1.0.x to be allowed.
that is what i want to do, well not exactly the same.
i want to filter page by user.
lo que quiero hacer es filtrar por usuario, que unos puedan acceder a varias paginas y otros no.
Tim me dijo que para eso debia configurar a squid para que conozca la base de datos de los usuarios, aun no he tenido exito.
this project is great Tim!!
dre@GRASE-HOTSPOT:~$ sudo apt-get install grase-www-portal grase-conf-freeradius grase-conf-squid3 grase-conf-openvpn
Reading package lists… Done
Building dependency tree
Reading state information… Done
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:
The following packages have unmet dependencies:
grase-conf-freeradius: PreDepends: coova-chilli (>= 1.2.6grase3) but it is not going to be installed
grase-conf-squid3: Depends: squid3 (>= 3.1) but it is not going to be installed
E: Broken packages
Try a newer version of Ubuntu
Great work, once I had the correct version of ubuntu (11.04 worked for me) it came up no worries. All I was wondering was how to change the default prices for the data and time limits.
Older versions of Ubuntu don’t currently work as they don’t have a new enough version of squid3.
As for the default data and time limits, I’m working on a fix for that. Ideally, you use the groups feature to setup groups with a default data and time limit, and then just select that group.
As for the prices of data and time, they are under the main settings page.
Thanks for the great work. I’ve been trying to install on 10.04 LTS Server and was having the same issues as above. I’ll try with 11.04 and see how it goes.
Again, Thanks to EVERYONE!
Hello good work, I wanna know how can into to admin page from another pc using http://10.1.0.1/grase/radmin but no works can you help me with that please?
Please post support request to the mailing list.
The 10.1.0.1 address will work from a computer connected to the Hotspot, as long as you don’t change the default settings. If you wish to access this page from a machine on the WAN side of the Hotspot, you’ll need to find out it’s WAN ip address and use that in place of 10.1.0.1
Tim
Hi tim it really works now I wanna introduce a image in the portal customisation can u help me please?
Hey Tim, Just wanted to say GREAT WORK! This is an awesome system, but I did have to do some searching to find out that it needed Ubuntu 10.10 and also I had to write a script to auto-start chilli since there was something messed up there, but it was pretty easy to figure out.
Again, GREAT WORK!
Kyle
How to get GraseHotspot to work on ubuntu 11.01 when the two network cards are not configured well.
Make sure that you have disabled DHCP, Encryption, and Router feature in your AP or router (if exist)
1. $ ifconfig …. to see the interfaces.
2. $ sudo gedit /etc/chilli/config
to see part of the coova chilli configuration below….
# Local Network Configurations
#
HS_WANIF=${HS_WANIF:-eth1} # WAN Interface toward the Internet
HS_LANIF=${HS_LANIF:-eth0} # Subscriber Interface for client devices
3. Modify the interfaces to suite yours.
4. Restart and voila…… it should be working now
5. Access your admin hotspot interface from http://10.1.0.1/grase/radmin
Hi,
Can grase hotspot run or installed on Ubuntu Desktop 11.10 ? someon ehelp out
Yes Boniface it will work… am using a desktop version myself. You just need to install some other applications for it to work.
First you need to install lamp, followed by phpmyadmin
then you can continue with the grase installation from their website.
below is the command to install lamp and phpmyadmin
# sudo apt-get install php5 mysql-server apache2
follow the instructions then
# sudo apt-get install phpmyadmin
then continue with installation from http://grasehotspot.org/documentation/installation/
hope this was helpful
Thanks Bismark. sorry for the delay in responding. i have actually been busy studying for my masters exams. i tried installing grasehotpot as per your advise and after 2days of struggling it really worked out. thanks a lot.
Yes Boniface it will work… am using a desktop version myself. You just need to install some other applications for it to work.
First you need to install lamp, followed by phpmyadmin
then you can continue with the grase installation from their website.
below is the command to install lamp and phpmyadmin
# sudo apt-get install php5 mysql-server apache2
follow the instructions then
# sudo apt-get install phpmyadmin
then continue with installation from http://grasehotspot.org/documentation/installation/
hope this was helpful
How to get GraseHotspot to work on ubuntu 11.01 when the two network cards are not configured well. MODIFIED
Make sure that you have disabled DHCP, Encryption, and Router feature in your AP or router (if exist)
1. $ ifconfig …. to see the interfaces.
2. $ sudo gedit /etc/chilli/config
to see part of the coova chilli configuration below….
# Local Network Configurations
HS_WANIF=${HS_WANIF:-eth1} # WAN Interface toward the Internet
HS_LANIF=${HS_LANIF:-eth0} # Subscriber Interface for client devices
3. Modify the interfaces to suite yours (i.e. HS_WANIF:-eth1 and HS_LANIF:-eth0)
4. now edit the network interfaces by ( # sudo gedit /etc/network/interfaces )
5. add the ff line … (iface eth1 inet manual ) where eth1 is the lan interface
6. Restart Chilli and the whole system. ( # sudo service chilli restart ) and ( #sudo reboot).
7. Upon restart access admin hotspot interface from http://10.1.0.1/grase/radmin
8. Clients will be automatically redirected.
It’s not recommended changing the /etc/chilli/config file. The LAN and WAN interfaces are setup semi-automatically and via the admin interface.
The WAN interface (which should be plugged in while installing the packages) will be automatically detected based on the default gateway to the internet. So simply, if you have internet access while installing, which you should, it should detect the WAN interface correctly.
If you have more than 2 NIC’s, then the LAN interface won’t always be detected correctly, but can be selected in the Admin interface.
Thansk for giving assistance Bismark!
i installed this software on ubuntu 11.10 and don’t work perfectly !!! i create an account in the admin interface and whene i connect from client post the loin succeed but ther is no internet connection…
is there any specials tips for install Grase ??
thx
Hi Amma
I think you will need to post in the mailling list for more support on this.
Also include details like
Whether you installed as a Virtual machine or whether it is installed on a physical pc on its own with ubuntu and whether there is 1 or 2 network cards. how the network cards are setup
and possibly a diagram of how you have it setup
But in short you will find
Network Eth0 = Internet
Network Eth1 = Local Network or switch.
There are some issues installing this package on top of a desktop client of ubuntu that you need to be aware of and this gets a little explained in the hardware setup link at top right of page.
you can thank network manager for this
Hi Tim,
how many co-current users can grasehotspot support?
This is dependant mostly on the PC running the hotspot system.
If your running an old pc or slow system as ur server then con-current users will be lower than that of a more up to date system.
Things to be aware of
Harddrive Speed – Access Speed
Ram Amount available via amount used
CPU processor Speed
and of course the network cards
1gb network interface cards will work better than 100mb network interface cards.
same applies to the rest of the network the server is implemented on with it being 100mb network or 1gb network. and so on
thanks scrugio
is there anyway to limit the speed of each user?
I have installed the server and it looks great.
but there is one thing i need help.
some of my users are supposed to get local(internal) IP addresses while others need to get live (external) IP addresses.
how can i configure that?
u may need to elaborate on this a bit more but from what i get
PC 1, 2, 3 need to be accessible from the wan
PC 4, 5, 6 dont need to be assesable from wan but have access to wan from the lan.
Could u explain the reason for this need ? is it the pc or user different, users on same pc or same user on different pcs. more details to understand the issue would be good to arrive at a solution.
it would also be suggestive to post via the maillist to get a wider community of grase users who may also be able to help with this solution your looking for.
If that’s the case, you could potentially use a router running DDWRT and set up VLAN’s for specific ports to do what is needed there. I don’t know about them being able to have a separate address, but using ACL’s on the different VLAN’s you could potentially have the specific computers access network resources that way and prevent the other computers not have access to those resources.
Just a suggestion. I’m not 100% sure if that would work or not, but it might be worth a shot.
Yeah this would be one way but that would be entirely dependant on the network setup that Hanan Needs. if its specific users and not pcs this would be irrelevant. then again if Hanan wants PC to go thru the hotspot system but be assessable from wan then the most likely way would be adding and editing routing and config files to be of use.
again this is entirely on what kind of network Hanan actually wants and Hanan will need to be very very clear on specifically what is required.
for a server behind the hotspot for example. that users do need to use. u can setup 2 network cards on it and connect one card to the lan outside the hotspot. its accessable from wan but when u go to use the internet as a user it routes thru to the hotspot. any further comment really requires Hanan to be alot more specific on their network requirements.