Skip to content
Snippets Groups Projects
install_sbc.html 5.75 KiB
Newer Older
<!DOCTYPE html>
<html>
  <style>
    * {
        box-sizing: border-box;
    }

    a, u {
        text-decoration: none;
        color: #72a7cf;
        font-weight: bold;
    }

    a:visited{
        color: #72a7cf;
        font-weight: bold;
    }

    #headerpic {
        width: 60%;
        height: auto;
        margin-right : auto;
        margin-left : auto;
        min-width : 220px;
    }

    body {
        margin: 8%;
        font-family: Arial;
    }

    .header {
        text-align: center;
        padding: 32px;
    }

    .headertext {
        color: #72a7cf;
        text-align: center;
        font-size: 120%;
        font-weight: bold;
    }

    .subheadertext {
        text-align: center;
        font-size: 100%;
        font-weight: bold;
    }

    .doctext {
        text-align: left;
        font-size: 100%;
    }

    .clitext {
        text-align: left;
        font-size: 100%;
        font-family: Courier;
    }

    .row {
        display: -ms-flexbox;
        display: flex;
        -ms-flex-wrap: wrap;
        flex-wrap: wrap;
        padding: 0 4px;
    }

    .column {
        -ms-flex: 25%;
        flex: 25%;
        max-width: 25%;
        padding: 0 4px;
    }
    .columnempty {
        -ms-flex: 25%;
        flex: 25%;
        max-width: 25%;
        padding: 0 4px;
    }

    .column img {
        margin-top: 8px;
        vertical-align: middle;
    }

    @media screen and (max-width: 600px) {
        .column {
            -ms-flex: 50%;
            flex: 25%;
            max-width: 50%;
        }
        .columnempty {
            -ms-flex: 0%;
            flex: 0%;
            max-width: 0%;
        }
    }

    @media screen and (max-width: 200px) {
        .column {
            -ms-flex: 25%;
            flex: 25%;
            max-width: 25%;
        }
    }
  </style>
  <body>

    <div class="header">
      <a href="install.html"><img id="headerpic" class="img-responsive" src="images/logo.png"></a>

      <p class="headertext">Install on a Single Board Computer (SBC)</p>

      <p class="subheadertext">Do this on a separate machine, not the SBC itself</p>

      <p class="doctext"><b>1.</b> Install the <a href="install_dat.html">dat command</a></p>

      <p class="doctext"><b>2.</b> Make sure you have the <a href="install_xz.html">xz command</a> installed</p>

      <p class="doctext"><b>3.</b> Download the image for your SBC. The list of available dat files <a href="downloads/images.txt">is here</a>. If your SBC is not supported then you may still be able to install Freedombone if it can run Armbian. Details of installing on Armbian can be <a href="armbian.html">found here</a>.</a></p>

      <p class="clitext">
        dat clone dat://...<br>
        cd [cloned directory]<br>
        unxz
      </p>

Bob Mottram's avatar
Bob Mottram committed
      <p class="doctext"><b>4.</b> Plug in a microSD card. You might need an external reader device for this, or many laptops have an SDcard slot via which you can connect a microSD card within an adapter.</p>

      <p class="doctext"><b>5.</b> Find its device name, which usually begins with <b>/dev/sd</b> or <b>/dev/mmcblk</b>. One way of doing this is with the command</p>

      <p class="clitext">
        ls /dev/sd*
      </p>

      <p class="doctext">Before and after attaching the microSD drive</p>

      <p class="doctext"><b>6.</b> Now copy the extracted image to the microSD drive. This may take quite a while</p>

      <p class="clitext">
        sudo dd bs=1M if=freedombone-[your SBC].img of=/dev/sdX conv=fdatasync,sync,noerror
      </p>

      <p class="doctext"><b>7.</b> You may want to make sure that you use the whole of the available space on the microSD drive, using a tool such as <b>gparted</b> to resize the partition</p>

      <p class="doctext"><b>8.</b> Remove the microSD drive and plug it into the SBC which will be your server</p>

      <p class="doctext"><b>9.</b> Plug your SBC into one of the ethernet sockets on your internet router using a USB patch cable (cat5 or cat6)</p>

      <p class="doctext"><b>10.</b> Make sure that the SBC has a mains power supply. Connect power to then SBC so that it boots</p>

      <p class="doctext"><b>11.</b> Ensure that <a href="https://en.wikipedia.org/wiki/Zero-configuration_networking">mDNS/zeroconf</a> is enabled on your internet router. The router settings are often accessed via <a href="http://192.168.2.1">192.168.2.1</a> or <a href="http://192.168.10.1">192.168.10.1</a> or <a href="http://192.168.1.254">192.168.1.254</a></p>

      <p class="doctext"><b>12.</b> If <i>avahi</i> is not available on your laptop (not the Freedombone server) then make sure you install it</p>

      <p class="doctext">On Debian</a>

      <p class="clitext">
        apt-get install avahi-utils avahi-dnsconfd
      </p>

      <p class="doctext">On Arch/Parabola</a>

      <p class="clitext">
        sudo pacman -S avahi nss-mdns<br>
        sudo sed -i 's|hosts:.*|hosts: files mdns_minimal [NOTFOUND=return] dns myhostname|g' /etc/nsswitch.conf
      </p>

      <p class="doctext"><b>13.</b> Browse the local network with</p>

      <p class="clitext">
        avahi-browse -at
      </p>

      <p class="doctext">If eveything is working you should notice that a system called <i>freedombone</i> appears in the list, with a <i>http</i> service</p>

      <p class="doctext"><b>14.</b> Open a web browser which is <b>not</b> a Tor browser and navigate to <b>http://freedombone/admin</b>, or if that doesn't work then try <b>http://freedombone.local/admin</b></p>

Bob Mottram's avatar
Bob Mottram committed
      <p class="doctext">Congratulations! You are now ready to begin setting up the server and installing apps. You will need to have purchased a <a href="domains.html">domain name</a>, and have a dynamic DNS account or equivalent arrangement so that the server domain name is resolvable from the wider internet.</p>

    </div>

  </body>
</html>