User Tools

Site Tools


Getting started with Guinnux 5

The setup of Guinnux largely depends on the platform you choose to install Guinnux on. This page covers basic setup and usage of Guinnux 5 development kits. However, we also have pages describing the setup on other platforms.

Other Platforms:

Connecting to the board

Connecting to a Guinnux 5 (Blue Penguin) board is a relatively simple process.

Connecting to the board using a web browser:

  1. Connect a USB cable to the USB type B (square) port.
  2. Open any web browser and type into the address bar, the configuration website should open.
  3. You will be greeted with the following login page:
  4. Log in using the username and password, the default username and password is both “admin”.
  5. From here you can configure the board as shown in the configuration website section.

Connecting to the board using a terminal:

  1. Connect a USB cable to the USB type B (square) port.
  2. SSH to the board using the following command:
     $ ssh root@ 
  3. You will be prompted for a password, the default is “bigbang”.
  4. Once you are logged in you can configure the board using a terminal.

Configuration Website

The Guinnux Configuration Website is installed as part of the Guinnux distribution by default. This is a website hosted on the Guinnux board and can be used to monitor and tweak various parts of the Guinnux installation.

Once you have logged in you will be greeted with the following page:

From here you can navigate to various different pages that will allow you to set up your network, install packages, etc.

Setting up Network

Setting up a network on a Guinnux 5 device is simple with the configuration site.

Viewing, configuring or enabling interfaces

From the main menu of the configuration site, navigate to the Network drop down menu. From here you van view interfaces, network status and network settings (DHCP, DNS and Firewall).

Clicking on the “Interfaces” link will show you all connected interfaces, their states, and their configurations:

In this case you can see that the ethernet interface is disabled. To enable it simply click on the interface name, check the box that says “enabled” and click on the “save and apply” button. You will see something like this:

To set a static IP, simply uncheck the DHCP checkbox and manually fill in the IP address, subnet mask, and default gateway.

Software management

Software management is also easy with the configuration site.

By clicking on the “search Packages” link you can search for a specific package, for example the search term, “python”, yields the following results:

Scroll down and look for the latest version of python:

If you click on the package name, you will be taken to a page that provides detailed information on the package, from here you can install (or uninstall) the package.

From the “Software” config site page you can also view all installed packages, change repository sources and view the status of all your installed packages.


Once you are connected to the board you can use all standard shell commands.

Common shell commands include:

  • cd - Change directory.
  • mkdir - Make a new directory.
  • rm - Remove an item.
  • ls - List the contents of the current directory.
  • ip addr show - Shows the ip address of the board.

See the Hello World example to see how you can use the toolchain and cross compiler to develop for Guinnux. Alternatively, Guinnux comes with LUA pre-installed or you can use the configuration site to install python if you want to jump right in.

gnx5gettingstarted/toc.txt · Last modified: 2017/05/18 07:42 by amelia