Skip to content

Commit c983a48

Browse files
committed
New README
1 parent f79e127 commit c983a48

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

agent/README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Intecture Agent
2+
3+
Intecture Agent is a tiny daemon that exposes Intecture's API as a service. To consume this service, use the `host::remote::Plain` type from [core](../core/).
4+
5+
### Usage
6+
7+
To run the agent, simply execute the `intecture_agent` binary, remembering to pass it a socket address to listen on.
8+
9+
For example, to listen to localhost on port 7101, run:
10+
11+
```sh
12+
intecture_agent --address localhost:7101
13+
```
14+
15+
More likely though you'll want to listen on your public interface so that Intecture can talk to the host remotely. In this case you should specify the host's IP address manually, or use `0.0.0.0` to listen on all interfaces.
16+
17+
### Config file
18+
19+
You can also store agent parameters in a configuration file. The file must be in TOML format, and can live anywhere on your server. It should look like this:
20+
21+
```toml
22+
address = "0.0.0.0:7101"
23+
```
24+
25+
Once you've created a config file, pass it to the agent binary:
26+
27+
```sh
28+
intecture_agent --config agent.toml
29+
```

0 commit comments

Comments
 (0)