summaryrefslogtreecommitdiffhomepage
path: root/README.md
diff options
context:
space:
mode:
authorAva Hahn <a.hahn@f5.com>2024-04-16 16:20:06 -0700
committeravahahn <110854134+avahahn@users.noreply.github.com>2024-04-18 16:56:45 -0700
commita48fbc035c699c41892c480ed88494e53debea72 (patch)
tree16e7886afe91be02ce4b7f535ac4438a6ff7e8f9 /README.md
parent678c05686996e0aa6ddf79bf71279425306e9113 (diff)
downloadunit-a48fbc035c699c41892c480ed88494e53debea72.tar.gz
unit-a48fbc035c699c41892c480ed88494e53debea72.tar.bz2
Add additional information to the README
* expand on docker instructions * identify API documentation * identify WASM documentation Acked-by: Andrew Clayton <a.clayton@nginx.com> Signed-off-by: Ava Hahn <a.hahn@f5.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 23 insertions, 2 deletions
diff --git a/README.md b/README.md
index dfa0572b..6ec5c83a 100644
--- a/README.md
+++ b/README.md
@@ -42,12 +42,22 @@ For details and available language packages, see the
``` console
$ docker pull unit
+$ mkdir /tmp/unit-control # customize as needed.
+$ docker run -d \
+ --mount type=bind,src=/tmp/unit-control,dst=/var/run \
+ --mount type=bind,src=.,dst=/www \
+ --network host \
+ unit
```
For a description of image tags, see the
[docs](https://unit.nginx.org/installation/#docker-images).
+Your current working directory will now be mounted to the Unit image at `/www`.
+You can reach its socket at `/tmp/unit-control/control.unit.sock` assuming no
+further customizations have been made.
+
### Amazon Linux, Fedora, Red Hat
``` console
@@ -71,6 +81,15 @@ $ wget https://raw.githubusercontent.com/nginx/unit/master/tools/setup-unit && c
For details and available language packages, see the
[docs](https://unit.nginx.org/installation/#official-packages).
+## Configuration
+
+NGINX Unit provides a RESTful API for dynamic configuration.
+See the [control API documentation](https://unit.nginx.org/controlapi/)
+for more information on what endpoints are available and how to use them.
+
+
+For full details of configuration management, see the
+[docs](https://unit.nginx.org/configuration/#configuration-management).
## Running a Hello World App
@@ -161,8 +180,10 @@ Unit's output should contain both snippets, neatly organized:
}
```
-For full details of configuration management, see the
-[docs](https://unit.nginx.org/configuration/#configuration-management).
+## WebAssembly
+Unit supports running WebAssembly Components (WASI 0.2).
+For more information see the
+[Unit Configuration Docs](https://unit.nginx.org/configuration/#configuration-wasm).
## OpenAPI Specification