Door opening server with user management AKA: "freesee"
Uses a raspberrypi and a solid-state relay to unlock the door
A node server running optionally elseware manages the users and serves the WebUI
You need is a RasberryPi and a Relay. Install rasbian then plugin the relay. It's recomended to use a signal pin above 8, because they will default to Low, and wont open the door on reboot. pin-layout
The server can be run on the PI or anywhere else. Docker images exist for ARM and x86.
The docker-compose.yml
file has been configured for ARM so on the PI,
from the cloned repo, run:
sudo docker-compose up -d
Navigate to http://localhost:3000 and login with the username and password admin
Change your password then add users and doors.
When creating a user they are given a random password, that you should email them.
Alternativly, if you dont want to use docker, from the cloned repo run:
npm install
then ./server --build
Once you have added a door in the WebUI,
copy the token then paste it into docker-compose.yml
replacing "abc123"
Then re-run sudo docker-compose up -d
After refreshing the WebUI, you should see the "Open" button appear for the door.
Alternativly, if you dont want to use docker, from the cloned repo run:
./door -k -s <SERVER_IP> -t <TOKEN>
To run in dev/dummy mode (i.e. you're not running this on a raspberry pi) just pass the -x
option. The dummy server will log responses to calls to open/close the door:
./door -x -k -s <SERVER_IP> -t <TOKEN>