{"id":13588894,"url":"https://github.com/alerta/alerta-webui","last_synced_at":"2026-02-27T23:31:45.333Z","repository":{"id":34093080,"uuid":"166264231","full_name":"alerta/alerta-webui","owner":"alerta","description":"Alerta Web UI 7.0","archived":false,"fork":false,"pushed_at":"2024-06-11T06:07:32.000Z","size":21358,"stargazers_count":116,"open_issues_count":67,"forks_count":63,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-08-26T09:33:35.843Z","etag":null,"topics":["alerta","console","vue","web"],"latest_commit_sha":null,"homepage":"https://try.alerta.io","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alerta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"satterly"}},"created_at":"2019-01-17T17:06:54.000Z","updated_at":"2025-06-30T02:36:39.000Z","dependencies_parsed_at":"2023-12-21T05:01:30.041Z","dependency_job_id":"299605e7-e4e8-4407-9483-7d4a7a45a902","html_url":"https://github.com/alerta/alerta-webui","commit_stats":null,"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/alerta/alerta-webui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Falerta-webui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Falerta-webui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Falerta-webui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Falerta-webui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alerta","download_url":"https://codeload.github.com/alerta/alerta-webui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alerta%2Falerta-webui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29918980,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"ssl_error","status_checked_at":"2026-02-27T19:37:41.463Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alerta","console","vue","web"],"created_at":"2024-08-01T15:07:00.632Z","updated_at":"2026-02-27T23:31:45.316Z","avatar_url":"https://github.com/alerta.png","language":"Vue","funding_links":["https://github.com/sponsors/satterly"],"categories":["Vue"],"sub_categories":[],"readme":"Alerta Web UI 7.0\n=================\n\n[![Actions Status](https://github.com/alerta/alerta-webui/workflows/CI%20Tests/badge.svg)](https://github.com/alerta/alerta-webui/actions) [![Slack chat](https://img.shields.io/badge/chat-on%20slack-blue?logo=slack)](https://slack.alerta.dev)\n\nVersion 7.0 of the Alerta web UI is a [VueJS](https://vuejs.org/) web app.\n\n![webui](/docs/images/alerta-webui-v7.png?raw=true\u0026v=1)\n\nInstallation\n------------\n\nTo install the web console:\n\n    $ wget https://github.com/alerta/alerta-webui/releases/latest/download/alerta-webui.tar.gz\n    $ tar zxvf alerta-webui.tar.gz\n    $ cd dist\n    $ python3 -m http.server 8000\n\n    \u003e\u003e browse to http://localhost:8000\n\nConfiguration\n-------------\n\nMost configuration will come from the Alerta API server. The minimum,\nand most common, configuration is simply to tell the web UI where the\nAPI server is located.\n\nEnvironment variables for some settings can be used at build time:\n\n    $ export VUE_APP_ALERTA_ENDPOINT=https://alerta-api.example.com\n    $ npm install\n    $ npm run build\n\nor place a `config.json` configuration file in the `dist` directory\nfor run time configuration:\n\n    {\n        \"endpoint\": \"https://alerta-api.example.com\"\n    }\n\nAny setting from the API server can be overridden if included in\nthe local `config.json` file. For a full list of supported settings\nsee the web UI config settings in the [online docs][1].\n\n[1]: https://docs.alerta.io/en/latest/webui.html#configuration-from-api-server\n\nAs a special case, support for setting an OAuth Client ID using a\nbuild-time environment variable is possible but should not be be\nnecessary for most deployments.\n\n    $ export VUE_APP_CLIENT_ID=0ffe5d26-6c66-4871-a6fa-593d9fa972b1\n\nQuick Start\n-----------\n\nA docker container that is built using the most recent master branch is\navailable for download from Docker Hub.\n\n    $ docker pull alerta/alerta-beta\n\n It can also be built locally using the `Dockerfile` in this repository.\n\n    $ docker build -t alerta/alerta-beta .\n\nTo run, create a `config.json` file and mount the file into the container\n\n    $ echo '{\"endpoint\": \"https://alerta-api.example.com\"}' \u003e config.json\n    $ docker run -v \"$PWD/config.json:/usr/share/nginx/html/config.json\" \\\n      -it -p 8000:80 --rm --name alerta-beta alerta/alerta-beta\n\nNote: Update the `CORS_ORIGINS` setting in the Alerta API server config\nto include the URL that the beta web console is hosted at otherwise\nthe browser will throw \"blocked by CORS policy\" errors and not work.\n\nDeployment\n----------\n\nSince this is a static web app then a production deployment of Alerta web UI\nis simply a matter of downloading the release tarball and copying the `dist`\ndirectory to the a location that can be served via a web server or CDN.\n\nSee the [VueJS platform guide][2] for more information.\n\n[2]: https://cli.vuejs.org/guide/deployment.html#general-guidelines\n\nTroubleshooting\n---------------\n\nThe two main issues with deployment in production involve CORS and HTML5\nhistory mode.\n\n### Cross-origin Errors (CORS) ###\n\nAll modern browsers restrict access of a web app running at one domain to\nresources at a different origin (domain). This mechanism is known as [CORS][3].\n\n[3]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS\n\nTo ensure that the Alerta web app has permission to access the Alerta API\nat a different origin the web URL needs to be added to the `CORS_ORIGINS`\nsettings for the API.\n\nSee [API server configuration][4] for more details.\n\n[4]: https://docs.alerta.io/en/latest/configuration.html#cors-config\n\n### HTML5 History Mode\n\nThe web app uses [HTML5 history mode][4] so you must ensure to configure\nthe web server or CDN correctly otherwise users will get `404` errors when\naccessing deep links such as `/alert/:id` directly in their browser.\n\nThe fix is to provide a [catch-all fallback route][5] so that any URL that\ndoesn't match a static asset will be handled by the web app and redirected.\n\n**Example using nginx**\n```\nlocation / {\n  try_files $uri $uri/ /index.html;\n}\n```\n\n[5]: https://router.vuejs.org/guide/essentials/history-mode.html\n[6]: https://router.vuejs.org/guide/essentials/history-mode.html#example-server-configurations\n\nDevelopment\n-----------\n\nProject setup\n```\nnpm install\n```\n\nCompiles and hot-reloads for development\n```\nnpm run serve\n```\n\nCompiles and minifies for production\n```\nnpm run build\n```\n\nTests\n-----\n\nRun your tests\n```\nnpm run test\n```\n\nLints and fixes files\n```\nnpm run lint\n```\n\nRun your end-to-end tests\n```\nnpm run test:e2e\n```\n\nRun your unit tests\n```\nnpm run test:unit\n```\n\nLicense\n-------\n\n    Alerta monitoring system and console\n    Copyright 2019-2021 Nick Satterly\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n        http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falerta%2Falerta-webui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falerta%2Falerta-webui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falerta%2Falerta-webui/lists"}