This project comes as a pre-built Docker image that enables you to utilize a relay and Raspberry Pi to open a gate, garage door, trigger a deer feeder or anything else that involves shorting a circuit. Includes a mobile-friendly admin dashboard and API endpoints that will allow you to manage users and control one or more relays from a single Raspberry Pi.
This is the hardware I am using. You can certainly do this with less. A pi0, jumper wires, and any relay will work.
2. Add the current user to the docker group to avoid using sudo. You must log out and back in after doing this, otherwise you will need to sudo the rest of the commands!:
sudo usermod -aG docker ${USER}mkdir clickpi && cd clickpi && nano docker-compose.yml services:
<
7D11
span class="pl-ent">click_pi:
image: christracy/clickpi
restart: unless-stopped
privileged: true
environment:
FRIENDLY_NAME: "My Garage Door" # Name of the device you're controlling. Will show up in logs and responses
SECRET_KEY: "LongSuperSecretKey" # This can be anything but it should be long, random, and kept secret
ADMIN_PASSWORD: "SuperSecretPassword" # Password for the admin panel
GPIO_PIN: "16" # GPIO PIN used for the trigger route (this is the GPIO number, NOT the pin number)
#API_EXPIRATION_DAYS: 90 # Number of days before the API token will expire (Default: 365)
#CLICK_DELAY: .50 # Time between closing and opening the relay on the trigger route (Default: .10)
#TRIGGER_LIMIT: 5 # The number of times the trigger routes can be called within 1 minute (Default: 8)
volumes:
- ./db:/data
ports:
- "5151:5151"
- "5252:5252"
docker compose up -ddocker-compose pulldocker-compose up -d| Method | URI | Description | Params | Auth |
|---|---|---|---|---|
POST |
{default_host}/api/v1/trigger |
Triggers the relay with the default GPIO pin | api_key |
|
POST |
{default_host}/api/v1/customtrigger |
Triggers the relay but you can specify the GPIO pin and time | pin click_delay |
api_key |
- Home Assitant (HACS) - Add this to your custom repositories in hacs for a garage door:
https://github.com/christracy/clickpi_garage_door. For detailed instructions refer to the clickpi_garage_door repo.