Getting Started (Software)

Greetings and thanks for your interest in the OpenRepeater Project. This Getting Started Guide is intended to help you get the software portion of the project up and running quickly. For hardware connection to your radios, please visit our Getting Started Guide on Hardware.

SD Image Setup Requirements

In order to setup your pre-configured boot-able SD card you will need the following:
  • Micro SD Card of 4GB or Greater
  • Card Reader capable of reading larger SDHC cards
  • An Imaging Application such as ApplePi-Baker (Mac) or Win32DiskImager (Windows)
  • A SD image from our download page for supported boards.

Building the SD Card

Please choose the appropriate platform you will be imaging your SD card from:
  1. Windows (Win32DiskImager)
    Win32 Disk Imager
    1. Download and install the Win32DiskImager utility (if you haven't already).
    2. Obtain the latest copy of the disk image for the project from our Downloads page.
    3. Extract the image file from the downloaded .zip/.gz file, so you now have "distribution-name.img". (You may need 7zip for this step)
    4. Insert the SD card into your SD card reader verify it's drive letter.
    5. Run the Win32DiskImager (Depending on your computer and os , you many need to run with Administrator rights.)
    6. Select the image file you extracted above.
    7. Select the drive letter of the SD card in the device box. WARNING: Make sure to select the correct drive! You could inadvertently damage your hard drive if you are not careful.
    8. Click Write and wait for the write to complete.
    9. Exit Win32DiskImager and eject the SD card.
  2. Mac (ApplePi-Baker)
    ApplePi-Baker
    1. Download and install the ApplePi-Baker application (if you haven't already).
    2. Obtain the latest copy of the disk image for the project from our Downloads page.
    3. Extract the image file from the downloaded .zip/.gz file, so you now have "distribution-name.img".
    4. Insert the SD card into your SD card reader.
    5. Run ApplePi-Baker.
    6. Select the SD card under "PI-Crust : Possible SD-Cards". WARNING: Make sure to select the correct drive! You could inadvertently damage your hard drive if you are not careful.
    7. Under "Pi-Ingredients", select the image file you extracted above.
    8. Click on the "IMG to SD-Card" button and wait for the write to complete.
    9. Quit ApplePi-Baker and eject the SD card.
  3. Other OS / Applications
    The instruction for ApplePi-Baker (Mac) or Win32DiskImager (Windows) are intended to be the most straight forward installation options to get the average user up and running as quickly as possible. There are a number of other GUI and command line utilities that you can uses if you are familiar with them. Use these at your own discretion following the general procedure listed below:
    1. Make sure that you have an appropriate application for writing IMG files to SD cards for your operating system.
    2. Obtain the latest copy of the disk image for the project from our Downloads page.
    3. Extract the image file from the downloaded .zip/.gz file, so you now have "distribution-name.img".
    4. Insert the SD card into your SD card reader.
    5. Run your imaging application and follow the instructions that came with it to write your IMG file to SD card so that is is bootable
    6. Quit your imaging application and eject the SD card.

Booting Up

The boards are intended to run "headless" (meaning without a monitor and keyboard). If you want you can plug a monitor or TV in via the HDMI port to watch what is happen, otherwise you can SSH into the board. Some boards have a jtag/uart interface for a serial console interface. you may also connect this route for termianl control.
  • Make sure that the SD Card that you prepared above is properly installed in the board SD card socket.
  • You may connect your network cable to the Ethernet port on the board. See the section below about connecting to the network.
  • Depending on the board you use, connect the proper 5 VDC power adapter for your board to the power plug or micro usb power connection. If you are uncertain what your board required, we suggest that you purchase the power supply for your board at the time you purchase the board.
  • Upon powering the board, you should see the status lights flashing on the board as it boots. The function of these will vary depending on your board.

Connecting to the Network

ipscan-vistaPlug the board into your network. By default it will get an IP address via DHCP. You can use an app like the Angry IP Scanner (for Windows/Mac/Linux) or iNet Network Scanner (for Mac) to find out what the IP address of your device is on your local network. You may also be able to use the DCHP client list from your network router's administration page to find this IP address. For a long term solution, you may want to SSH into the board and set the IP address to a static address for more consistency.

Advanced Networking (Optional)

  1. Keyboard & Monitor
    While the OpenRepeater is designed to run headless, you may wish to connect it up to a keyboard and monitor for the initial setup and testing. Most single board computers have video out in some form, usually HDMI or Micro HDMI. What you will need:
    • A monitor or TV that supports HDMI, DVI, or another appropriate input
    • The appropriate cabling to go from your SBC to the monitor
    • A USB Keyboard
    • (Optionally) A USB Hub if your SBC doesn't have enough USB ports
    It pretty simple, just connected up the monitor with the appropriate cables, plug in the keyboard in a USB port (use a USB Hub if required) and power on the board. You can use the same username and password as you would with SSH.

    Default Root Login Username: root Password: OpenRepeater   Note: Previous beta versions might have used the following logins: RPI 2: root/debian (username/password) & Odroid C1: root/odroid (username/password). This has been fixed on newer releases.

    Once you are logged in to the command line, you can issue commands as usually. Use ifconfig to find the assigned IP address for your ethernet port (eth0). This is the IP address you will need to log into the Web Control Panel. Note: Don't forget to change your password to secure the root account.
  2. SSH
    If you plan to log in via SSH, then you have already discovered your device IP address (or will have to) using one of the other means. Once you know that you will be able to log into the Web Control Panel as well as use SSH for other command line functions. You will need to use an app on your computer that is capable of connecting via SSH, like PuTTY for Windows or the built in Terminal application on the Mac.
    • For PuTTY on Windows, select the SSH mode,  enter the IP address and a port of 22 and save the session if desired. Open the connection and enter the password.
    • For Terminal on the Mac, at the command prompt enter ssh root@xxx.xxx.xxx.xxx and then press enter...(xxx.xxx.xxx.xxx) being the IP address you discovered earlier. Enter the password and the prompt will change to that of the remote OpenRepeater server.

    Default Root Login Username: root Password: OpenRepeater   Note: Previous beta versions might have used the following logins: RPI 2: root/debian (username/password) & Odroid C1: root/odroid (username/password). This has been fixed on newer releases.

    Once you are logged in via SSH, you can issue commands as usually. Note: Don't forget to change your password to secure the root account.
  3. UART / Serial Connection
    Another alternative to access your board if you need to obtain your IP or be able to set a static address is to use the UART serial connection on many boards. We won't go into specifics for your board here, but the basic steps are as follows:
    • Connect a USB to TTL adapter appropriate for your board to the UART pins. In most cases you will be connecting the ground lines and then crossing over the TX and RX lines...so TX to RX and RX to TX.
    • Using an app on your computer that is capable of connecting via a serial terminal mode, like PuTTY for Windows or CoolTerm for Mac.
    • Select the appropriate port and baud settings for your USB to TTL adapter.
    • Connect
    • Login using the username and password.

    Default Root Login Username: root Password: OpenRepeater   Note: Previous beta versions might have used the following logins: RPI 2: root/debian (username/password) & Odroid C1: root/odroid (username/password). This has been fixed on newer releases.

    Once you are logged in to the command line, you can issue commands as usually. Use ifconfig to find the assigned IP address for your ethernet port (eth0). This is the IP address you will need to log into the Web Control Panel. Note: Don't forget to change your password to secure the root account.

Connect to the Web Control Panel

login To connect to the web based configuration interface:
  • Go to https://xxx.xxx.xxx.xxx  (192.168.xxx.xxx) of the repeater board and click the login button on the splash page. NOTE: You may get a browser warning about an untrusted SSL Certificate...proceed anyways.
  • At the login prompt, enter the username and password and click login.

Default Web Login Username: admin Password: openrepeater

  • Once You're login in we recommend you change your password. You can do this by selecting the user dropdown in the upper right of the page.

The Setup Wizard

The first time that you log in on your new install you will be presented with a setup wizard. This will help you set the basic settings to help get your system up and running. You will need to make sure that your sound device is connected before proceeding

Expanding the File System

Chances are that your SD card is larger than the IMG file written to it above. To utilize all the space on the card (unpartitioned space) you will need to expand the file system to fill the entire card.

Note about Security

For development purposes, the system is pretty loose security wise: root access, simple passwords, etc. This is the responsibility of each developer to lock down to their liking. This will be locked down later when coming out of the beta testing phase.