# OpenCanary

## Device preparation

1. Install OS [Armbian 11 Bullseye](https://download.csec.ba/tinkerboard/Armbian_11.img.xz). During installation process create user canary.

2. Update and upgrade
```bash
sudo apt update && sudo apt upgrade -y
```

3. Download OpenCanary config file
```bash
wget https://download.csec.ba/tinkerboard/opencanary.conf
```

4. Install Python3
```bash
sudo apt install -y python3-dev python3-pip python3-venv
```

5. Install prerequisites
```bash
sudo apt install -y build-essential libssl-dev libffi-dev libpcap-dev net-tools
```

6. Install Rust
```bash
sudo apt install rustc -y
```

7. Instal Cargo
```bash
sudo apt install cargo -y
```

8. Disable build Rust
```bash
export CRYPTOGRAPHY_DONT_BUILD_RUST=1
```

9. Install dependencies
```bash
mkdir opencanary
cd opencanary
python3 -m venv env
source env/bin/activate
pip install wheel
#sudo install rdpy (not working in the latest release)
pip install opencanary
pip install scapy pcapy
```

10. Create config file and copy it to the path
```bash
opencanaryd --copyconfig
sudo cp /home/canary/opencanary.conf /etc/opencanaryd/opencanary.conf
sudo mv /home/canary/opencanary.conf /home/canary/opencanary/opencanary.conf
```

11. Create OpenCanary service
```bash
sudo nano /etc/systemd/system/opencanary.service

#Add following lines into it
[Unit]
Description=OpenCanary
After=syslog.target
After=network.target

[Service]
User=root
Type=simple
RemainAfterExit=yes
Restart=always
ExecStart=/home/canary/opencanary/env/bin/opencanaryd --start
ExecStop=/home/canary/opencanary/env/bin/opencanaryd --stop

[Install]
WantedBy=multi-user.target
```

12. Enable and start service
```bash
sudo systemctl enable opencanary && sudo systemctl start opencanary
```

- or symply download install script to avoid all manual work
```bash
wget https://download.csec.ba/tinkerboard/opencanary.sh
#Make it executable
sudo chmod +x opencanary.sh
#Execute script
sudo ./opencanary.sh
```