Skip to content

Commit 9f10eec

Browse files
author
Paul Philion
committed
updating docs
1 parent 14f38e3 commit 9f10eec

File tree

1 file changed

+22
-2
lines changed

1 file changed

+22
-2
lines changed

docs/netbot.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,12 @@
22

33
## Setup Checklist
44

5+
1. Install `uv`: https://docs.astral.sh/uv/getting-started/installation/
6+
1. Clone the project: `git clone https://github.com/Local-Connectivity-Lab/netbot.git; cd netbot`
57
1. Configure `.env` file with Redmine and Discord settings
68
1. Generate the [Discord token](#discord-token)
79
2. Generate the [Redmine token](#redmine-token)
8-
2. Deploy `netbot` container with `docker compose`
10+
2. Deploy `netbot` container: `docker compose up --build -d`
911
3. Confirm operation with `docker logs`
1012

1113
To start, you will need the URL of the Redmine server you're integrating with, and admin access to that redmine instance.
@@ -14,7 +16,7 @@ To start, you will need the URL of the Redmine server you're integrating with, a
1416
## Cheatsheet
1517

1618
* To deploy the latest: `git pull; docker compose up --build -d`
17-
* To shudown netbot: `docker cmopose down`
19+
* To shudown netbot: `docker compose down`
1820
* To check for errors in the logs: `docker logs netbot | grep ERROR`
1921

2022

@@ -37,6 +39,24 @@ DISCORD_TOKEN=ABC-ANOTHER-TOKEN-DEF
3739
Once the `.env` file has been created, the container can be started
3840

3941

42+
## Development
43+
44+
`uv` is used to manage Python environment, build and run netbot. https://github.com/astral-sh/uv/
45+
46+
47+
### Operation
48+
49+
To run tests: `uv run -m tests`
50+
51+
To run a local development version: `uv run -m netbot.netbot debug sync-off`
52+
53+
Parameters `uv run -m netbot.netbot` accepts:
54+
* `debug`: Turn on debug logging
55+
* `sync-off`: Disable the periodic sync operations
56+
57+
To run netbot in a container...
58+
59+
4060
## Docker Compose
4161

4262
`netbot` uses standard Docker compose:

0 commit comments

Comments
 (0)