This guide assumes a certain level of familiarity with [Meshtastic](meshtastic.org), and [Meshtastic nodes](https://meshtastic.org/docs/getting-started/).
The Femtofox is similar to, and can functionally replace, a [Raspberry Pi Linux Native Meshtastic node](https://meshtastic.org/docs/hardware/devices/linux-native-hardware/). However, the Foxbuntu OS takes away most of the heavy lifting of a typical install, leaving you free to build your mesh application without the initial hurdles.
### Hardware
To get started, you will need a Femtofox. You can either build or buy one.
Directions for ordering PCBs and building a Femtofox can be found in the [Community Hardware repo](https://github.com/femtofox/Femtofox_Community_Hardware).
1. Download the latest image of Foxbuntu from the releases [https://github.com/femtofox/Femtofox/releases/] and extract from the 7z file with [7z program](https://www.7-zip.org/) or suitable alternative.
2. Use an image flashing tool such as [Balena Etcher](https://www.balena.io/etcher) to flash the image to a suitable SD card (see [supported hardware](./supported_hardware.md)).
Note: the image will not appear bootable to Etcher, but will be functional in use.
3. Insert the SD card into the reader of the Femtofox.
Foxbuntu is ready to operate almost from the first boot. The settings can be configured using one of the following methods:
<details>
<summary><B> Command Line </B></summary>
1. Serial console - Connect a USB-C cable to the power/serial port (Femtofox Pro) or connect a serial-USB adaptor to TX/RX/Gnd of UART2 (Femtofox CE).
2. SSH via Ethernet - connect a network cable either through the RJ45 port or by soldering directly to the Ethernet headers of the Luckfox (possible but not recommended) and connect it to your network. Identify the IP address via your DHCP server (e.g. your router) and connect using an SSH client of your choice.
After first login, run `sudo femto-config` from the command prompt, and launch the setup wizard.
[ 3. Web tool via Wifi AP mode - if a wifi adaptor is identified at first boot, and no configuration is provided for it, then the Femtofox will automatically generate a wifi hotspot to allow configuration. Connect to the wifi hotspot and access the web config tool using `192.168.4.1` in a browser.]: #
[ 4. SSH via Wifi AP mode - ... ]: #
</details>
<details>
<summary><B> USB Config </B></summary>
See [this page](./usb_config.md) for details on how to configure via a USB drive.
</details>
### Mesh Applications
Femtofox is supplied with pre-installed copies of many popular applications, such as:
1. [Meshing Around](https://github.com/SpudGunMan/meshing-around) - a popular auto-responder/query handler/BBS/everything else.
2. [TheCommsChannel BBS](https://github.com/TheCommsChannel/TC2-BBS-mesh) - a popular BBS application
3. [Curses Client for Meshtastic](https://github.com/pdxlocations/curses-client-for-meshtastic) - the simplest, most retro client possible
Additional applications may be added to the default image in future.
### Updating
Foxbuntu, Meshtasticd and the mesh applications can be updated as using the `Femto-Config` tool.