summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorArthur Taylor <codders@octomonkey.org.uk>2016-11-22 10:56:20 +0100
committerGitHub <noreply@github.com>2016-11-22 10:56:20 +0100
commit8e9d234dcfe03a24409829ddd31b51bd8f840345 (patch)
treed1d833d732faf4c8709e975a4bb6129acc3d0f76 /README.md
parent0167dce98692f707b74395977c478c2ca44fa0c7 (diff)
parent4b50e1cb0945adbbcc07dfcb65a9252e7523105d (diff)
downloadrvi_sota_client-8e9d234dcfe03a24409829ddd31b51bd8f840345.tar.gz
Merge pull request #9 from advancedtelematic/stableHEADmaster
Merge latest stable advancedtelematic
Diffstat (limited to 'README.md')
-rw-r--r--README.md58
1 files changed, 6 insertions, 52 deletions
diff --git a/README.md b/README.md
index 3750675..41db865 100644
--- a/README.md
+++ b/README.md
@@ -1,56 +1,10 @@
-# SOTA client
+# SOTA Client
The client source repository for [Software Over The Air](http://advancedtelematic.github.io/rvi_sota_server/) updates.
-## Prerequisites
+## Documentation
-The simplest way to get started is via [Docker](http://www.docker.com), which is used for compiling and running the client.
-
-Alternatively (and optionally), local compilation requires a stable installation of Rust and Cargo. The easiest way to install both is via [Rustup](https://www.rustup.rs).
-
-## Running the client
-
-With Docker installed, `make run` will start the client.
-
-### Makefile targets
-
-Run `make help` to see the full list of targets, which are:
-
-Target | Description
--------------: | :----------
-run | Run the client inside a Docker container.
-clean | Remove all compiled libraries, builds and temporary files.
-test | Run all cargo tests.
-doc | Generate documentation for the sota crate.
-clippy | Run clippy lint checks using the nightly compiler.
-client | Compile a new release build of the client.
-image | Build a Docker image for running the client.
-deb | Create an installable DEB package of the client.
-rpm | Create an installable RPM package of the client.
-version | Print the version that will be used for building packages.
-
-## Configuration
-
-You can configure how the client starts with `make run` by setting the following environment variables:
-
-Variable | Default value | Description
--------------------: | :------------------------ | :------------------
-`AUTH_SECTION` | `false` | Set to true to authenticate on startup.
-`CONFIG_ONLY` | `false` | Set to true to generate a config file then quit.
-`AUTH_SERVER` | http://127.0.0.1:9001 | The Auth server for client authentication.
-`CORE_SERVER` | http://127.0.0.1:9000 | The Core server for client communication.
-`REGISTRY_SERVER` | http://127.0.0.1:8083 | The server used for registering new devices.
-`OUTPUT_PATH` | `/etc/sota.toml` | Path to write the newly generated config.
-`TEMPLATE_PATH` | `/etc/sota.toml.template` | Path to the template for new config files.
-`DEVICE_VIN` | (generated) | Use this VIN rather than generating a new one.
-`DEVICE_UUID` | (generated) | Use this UUID rather than generating a new one.
-`AUTH_CLIENT_ID` | (from registry server) | Use this client ID for authentication.
-`AUTH_CLIENT_SECRET` | (from registry server) | Use this client secret for authentication.
-
-For example, running `CONFIG_ONLY=true make run` will output a newly generated `sota.toml` to stdout then quit.
-
-### Further customization
-
-Every value in the generated `sota.toml` config file can be overwritten in the `run/sota.toml.env` file.
-
-In addition, each config value is available as a command line flag when starting the client. Command line flags take precedence over the values set in the config file. Run `sota_client --help` to see a full list.
+* [Building the SOTA Client.](http://advancedtelematic.github.io/rvi_sota_server/cli/building-the-sota-client.html)
+* [Configuring the SOTA Client.](http://advancedtelematic.github.io/rvi_sota_server/cli/client-startup-and-configuration.html)
+* [Deploying the SOTA Server.](http://advancedtelematic.github.io/rvi_sota_server/doc/deployment-with-dockercompose.html)
+* [The `Command` and `Event` API reference.](http://advancedtelematic.github.io/rvi_sota_server/cli/client-commands-and-events-reference.html)