index.rst

Linux Installation

Quick Install

Debian (Ubuntu) and Fedora systems can use the scripted installer.

1. Prepare installation directory

   Let's use /opt as the main directory for tools and Sming.

   Regular users may not have access to /opt, so do this:

   sudo chown $USER:$USER /opt

   (alternatively, use a different directory).

2. Install GIT

   Debian:

   sudo apt-get install -y git

   Fedora:

   dnf install -y git

3. Fetch the Sming repository

   git clone https://github.com/SmingHub/Sming /opt/sming

4. Run the installer

   source /opt/sming/Tools/install.sh all

If you want to save disk space then you can select which tools to install. Get a list of available options like this:

/opt/sming/Tools/install.sh

Install locations can be customised by setting environment variables before running the install. See /opt/sming/Tools/export.sh for details.

If you want to use the stable (release) branch:

cd /opt/sming
git checkout master
git pull

Build a ‘Basic Blink’ example

Change to the application directory and build:

cd $SMING_HOME/../samples/Basic_Blink
make

Flash to your device (using default serial port):

cd $SMING_HOME/../samples/Basic_Blink
make flash

Next steps

Proceed to :doc:`../config`.