44 lines
965 B
Markdown
44 lines
965 B
Markdown
# OONI Probe CLI
|
|
|
|
The next generation OONI Probe Command Line Interface.
|
|
|
|
## User setup
|
|
|
|
1. Go [into the releases](https://github.com/ooni/probe-cli/releases) and download the release for your architecture and platform
|
|
|
|
2. Extract the tarball with `tar xvzf ooniprobe_*.tar.gz`
|
|
|
|
3. Copy the `ooniprobe` binary into a location in your `$PATH`, for example `/usr/local/bin/ooniprobe`
|
|
|
|
4. Run `ooniprobe run` to perform all the tests
|
|
|
|
Optional:
|
|
|
|
Add a crontab entry (on linux) to run `ooniprobe` daily at a random time:
|
|
|
|
```
|
|
(crontab -l 2>/dev/null; echo "$(( ( RANDOM % 60 ) + 1 )) $(( ( RANDOM % 24 ) + 1 )) * * * ooniprobe run") | crontab -
|
|
```
|
|
|
|
## Development setup
|
|
|
|
Be sure you have golang >= 1.13. We use Go modules. Make sure you
|
|
don't have GOPATH set.
|
|
|
|
Run
|
|
|
|
```
|
|
./build.sh help
|
|
```
|
|
|
|
to get information on the supported systems as well as to get
|
|
instructions on how to install dependencies.
|
|
|
|
## Releasing
|
|
|
|
```
|
|
./build.sh release
|
|
```
|
|
|
|
and follow instructions.
|