freedombone-prep(1)

NAME
freedombone-prep - Prepare a microSD card suitable for the Beaglebone Black

SYNOPSIS
freedombone-prep -d [microSD device] --image [img filename] --ip [BBB LAN IP address] --iprouter [Router LAN IP address] --mount [mount point] --ns1 [DNS IP 1] --ns2 [DNS IP 2]

DESCRIPTION
This utility prepares a microSD card ready to be used in a Beaglebone Black. It installs a minimal version of Debian and configures network settings.

INSTALLATION
To get started you will need:
  * A Beaglebone Black
  * A MicroSD card
  * An image previously created with the command "freedombone-image beaglebone"
  * Ethernet cable
  * Optionally a 5V 2A power supply for the Beaglebone Black
  * Access to the internet via a router with ethernet sockets
  * USB thumb drive (for backups or storing media)
  * One or more domains available via a dynamic DNS provider, such as https://freedns.afraid.org
  * A purchased domain name and SSL certificate (only needed for Red Matrix)
  * A laptop or desktop machine with the ability to write to a microSD card (might need an adaptor) You will also need to know, or find out, the IP address of your internet router and have a suitable static IP address for the Beaglebone on your local network. The router should allow you to forward ports to the Beaglebone (often this is under firewall or "advanced" settings). You can either install from a debian package or manually as follows:
    sudo apt-get update
    sudo apt-get install git build-essential
    git clone https://github.com/bashrc/freedombone
    cd freedombone
    sudo make install

USAGE
Plug the microSD card into your laptop/desktop and then run the freedombone-prep command. For example:
    freedombone-prep -d /dev/sdX --image [image filename] --ip <static LAN IP> --iprouter <router LAN IP> --mount /media/$USER where */dev/sdX* is the device name for the microSD card. Often it's */dev/sdb* or */dev/sdc*, depending upon how many drives there are on your system. The script will download the Debian installer and update the microSD card. It can take a while, so be patient. You can also specify DNS nameservers if you wish, such as:
    freedombone-prep -d /dev/sdX --image <image filename> --ip <static LAN IP> --iprouter <router LAN IP> --mount /media/$USER --ns1 213.73.91.35 --ns2 85.214.20.141 When the initial setup is done follow the instructions on screen to run the main Freedombone script

BUGS
Report bugs at https://github.com/bashrc/freedombone/issues

SEE ALSO
freedombone(1), freedombone-addcert(1), freedombone-clientcert(1), freedombone-addemail(1), freedombone-addlist(1), freedombone-addxmpp(1), freedombone-client(1), freedombone-ignore(1), freedombone-config(1), freedombone-remote(1), freedombone-renew-cert(1), freedombone-rmemail(1), freedombone-rmlist(1), freedombone-rmxmpp(1), freedombone-sec(1), freedombone-unignore(1), freedombone-xmpp-pass(1), freedombone-image(1)

AUTHOR
Bob Mottram <bob@robotics.uk.to>
PGP/GPG: EA982E38
Bitmessage: BM-2cWuhmBvVdfrHhLoZTdspCkKeiTorUesSL
Web: http://robotics.uk.to