2018-08-01 12:16:11 +02:00
|
|
|
# OONI Probe CLI
|
2018-02-12 17:33:13 +01:00
|
|
|
|
2018-08-01 12:16:11 +02:00
|
|
|
The next generation OONI Probe Command Line Interface.
|
2018-02-12 17:33:13 +01:00
|
|
|
|
2019-12-09 16:36:17 +01:00
|
|
|
## 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 -
|
|
|
|
```
|
|
|
|
|
2018-02-12 17:33:13 +01:00
|
|
|
## Development setup
|
|
|
|
|
2019-12-27 12:22:20 +01:00
|
|
|
Be sure you have golang >= 1.13. We use golang modules. Run
|
2018-02-12 17:33:13 +01:00
|
|
|
|
2019-11-14 10:14:25 +01:00
|
|
|
```
|
2019-05-15 14:48:06 +02:00
|
|
|
./build.sh help
|
2018-02-12 17:33:13 +01:00
|
|
|
```
|
|
|
|
|
2019-05-15 14:48:06 +02:00
|
|
|
to get information on the supported systems as well as to get
|
|
|
|
instructions on how to install dependencies.
|
2019-11-13 18:31:19 +01:00
|
|
|
|
|
|
|
## Releasing
|
|
|
|
|
2019-11-14 10:14:25 +01:00
|
|
|
```
|
2019-11-13 18:31:19 +01:00
|
|
|
./build.sh release
|
|
|
|
```
|
|
|
|
|
|
|
|
and follow instructions.
|