https://github.com/target/goalert
Open source on-call scheduling, automated escalations, and notifications so you never miss a critical alert
https://github.com/target/goalert
Last synced: 9 months ago
JSON representation
Open source on-call scheduling, automated escalations, and notifications so you never miss a critical alert
- Host: GitHub
- URL: https://github.com/target/goalert
- Owner: target
- License: apache-2.0
- Created: 2019-05-24T16:46:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-05-07T14:17:35.000Z (9 months ago)
- Last Synced: 2025-05-08T09:48:53.627Z (9 months ago)
- Language: Go
- Homepage: https://goalert.me
- Size: 52.2 MB
- Stars: 2,413
- Watchers: 33
- Forks: 256
- Open Issues: 147
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- Awesome - GoAlert - Open source on-call scheduling, automated escalations, and notifications so you never miss a critical alert. (Productivity Tools / Media Servers)
README
# GoAlert
GoAlert provides on-call scheduling, automated escalations and notifications (like SMS or voice calls) to automatically engage the right person, the right way, and at the right time.
## Installation
GoAlert is distributed as a single binary with release notes available from the [GitHub Releases](https://github.com/target/goalert/releases) page.
Additionally, images are published on [Docker Hub](https://hub.docker.com/r/goalert/goalert) for each release. The `latest` tag is the most recent release, and `nightly` is the latest build from the `master` branch.
See our [Getting Started Guide](./docs/getting-started.md) for running GoAlert in a production environment.
### Quick Start
```bash
docker run -it --rm -p 8081:8081 goalert/demo
```
GoAlert will be running at [localhost:8081](http://localhost:8081). You can log in with `admin`/`admin123`.
If you're using the demo container for integration testing:
- A non-admin user is available as `user`/`user1234`.
- You can specify the ENV variable `SKIP_SEED=1` to skip the initial seed data step.
- You can get a session token via `curl -XPOST -H 'Referer: http://localhost:8081' -d 'username=admin&password=admin123' 'http://localhost:8081/api/v2/identity/providers/basic?noRedirect=1'`.
## Contributing (Local Development)
If you'd like to contribute to GoAlert, please see our [Contributing Guidelines](./CONTRIBUTING.md) and the [Development Setup Guide](./docs/development-setup.md).
Please also see our [Code of Conduct](./CODE_OF_CONDUCT.md).
For most purposes, you can use `make start` from the root of this repo to start a development server.
- It will be running at `http://localhost:3030`
- Default login is `admin`/`admin123`
- Changes you make locally, UI and backend, should be reflected in the running server within a few seconds (no need to restart the server).
## Contact Us
If you need help or have a question, the `#goalert` Slack channel is available on [gophers.slack.com](https://gophers.slack.com/messages/goalert/).
To access Gophers Slack and the `#goalert` channel, you will need an invitation. You request one through the automated process here: https://invite.slack.golangbridge.org/
- Vote on existing [Feature Requests](https://github.com/target/goalert/issues?q=is%3Aopen+label%3Aenhancement+sort%3Areactions-%2B1-desc) or submit [a new one](https://github.com/target/goalert/issues/new)
- File a [bug report](https://github.com/target/goalert/issues)
- Report security issues to security@goalert.me
## License
GoAlert is licensed under the [Apache License, Version 2.0](./LICENSE.md).