github.com/simpleiot/simpleiot@v0.18.3/docs/user/installation.md (about)

     1  # Installation
     2  
     3  Simple IoT will run on the following systems:
     4  
     5  - ARM/x86/RiscV Linux
     6  - MacOS
     7  - Windows
     8  
     9  The computer you are currently using is a good platform to start with as well as
    10  any common embedded Linux platform like the Raspberry PI or Beaglebone Black.
    11  
    12  If you needed an industrial class device, consider something from embeddedTS
    13  like the [TS-7553-V2](https://www.embeddedts.com/products/TS-7553-V2).
    14  
    15  The Simple IoT application is a self contained binary with no dependencies.
    16  Download the [latest release](https://github.com/simpleiot/simpleiot/releases)
    17  for your platform and run the executable. Once running, you can log into the
    18  user interface by opening [http://localhost:8118](http://localhost:8118) in a
    19  browser. The default login is:
    20  
    21  - user: `admin`
    22  - pass: `admin`
    23  
    24  ### Simple IoT self-install (Linux only)
    25  
    26  Simple IoT self-installation does the following:
    27  
    28  - creates a systemd service file
    29  - creates a data directory
    30  - starts and enables the service
    31  
    32  To install as user, copy the `siot` binary to some location like
    33  `/usr/local/bin` and then run:
    34  
    35  `siot install`
    36  
    37  To install as root:
    38  
    39  `sudo siot install`
    40  
    41  The default ports are used, so if you want something different, modify the
    42  generated `siot.service` file.
    43  
    44  ## Cloud/Server deployments
    45  
    46  When on the public Internet, Simple IoT should be proxied by a web server like
    47  Caddy to provide TLS/HTTPS security. Caddy by default obtains free TLS
    48  certificates from Let's Encrypt and ZeroSSL with automatic fallback if one
    49  provider fails.
    50  
    51  There are Ansible recipes available to deploy Simple IoT, Caddy, Influxdb, and
    52  Grafana that work on most Linux servers.
    53  
    54  - [Simple IoT](https://github.com/simpleiot/ansible-role-simpleiot-bin)
    55  - [Caddy, Influxdb, Grafana, etc](https://github.com/cbrake?tab=repositories&q=ansible)
    56  
    57  ### [Video: Setting up a Simple IoT System in the cloud](https://youtu.be/pH8GPbjt-SI)
    58  
    59  <iframe width="791" height="445" src="https://www.youtube.com/embed/pH8GPbjt-SI" title="Setting up a Simple IoT System in the cloud" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
    60  
    61  ## Yocto Linux
    62  
    63  Yocto Linux is a popular edge Linux solution. There is a
    64  [Bitbake recipe](https://github.com/YoeDistro/yoe-distro/blob/master/sources/meta-yoe/recipes-siot/simpleiot/simpleiot_git.bb)
    65  for including Simple IoT in Yocto builds.
    66  
    67  ## Networking
    68  
    69  By default, Simple IoT runs an embedded NATS server and the SIOT NATS client is
    70  configured to connect to `nats://127.0.0.1:4222`.