Troubleshooting

Please submit an issue if these do not solve your exact problem 😃.

---

Couldn't load projects from file! no such file or directory

Check your --projectsfilepath flag points to a valid projects file.

The deploy script doesn't seem to be running?

• The deploy script should be executable. Make sure to run chmod +x deploy.sh.
• Check the logs (sudo systemctl status chappy.service for linux) for any errors.

Received event for <PROJECTNAME> but no project found

• Check your projects file is a JSON array, meaning the file wraps projects with []. See the README for how the projects file should be formatted.
• / are not allowed in project names. I'd love to fix this as you should be able to name projects like user/repo.
• Check the spelling of your project name and webhook URL.

Chappy fails to start in systemctl

Check your chappy.service file and make sure the User and Group are correct.

GitHub couldn't deliver this payload: Service Timeout

If you're running on a networked instance like AWS EC2, check your Security Group or firewall allows GitHub to access the server over the port you're running Chappy on. GitHub's IP addresses are listed on their support site.