{"id":28523972,"url":"https://github.com/cloudbase/coriolis-web","last_synced_at":"2025-10-11T21:11:56.298Z","repository":{"id":21807570,"uuid":"91190379","full_name":"cloudbase/coriolis-web","owner":"cloudbase","description":"Web UI for Coriolis","archived":false,"fork":false,"pushed_at":"2025-07-31T17:41:17.000Z","size":13198,"stargazers_count":3,"open_issues_count":1,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-07-31T20:36:18.081Z","etag":null,"topics":["coriolis","react"],"latest_commit_sha":null,"homepage":"http://coriolis.cloud","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2017-05-13T17:12:58.000Z","updated_at":"2025-07-31T17:41:21.000Z","dependencies_parsed_at":"2023-02-19T17:15:25.172Z","dependency_job_id":"73aa68f2-cb06-4046-a09e-5a9b0f7ff111","html_url":"https://github.com/cloudbase/coriolis-web","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/cloudbase/coriolis-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudbase%2Fcoriolis-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudbase%2Fcoriolis-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudbase%2Fcoriolis-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudbase%2Fcoriolis-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudbase","download_url":"https://codeload.github.com/cloudbase/coriolis-web/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudbase%2Fcoriolis-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008731,"owners_count":26084494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["coriolis","react"],"created_at":"2025-06-09T10:10:09.098Z","updated_at":"2025-10-11T21:11:56.270Z","avatar_url":"https://github.com/cloudbase.png","language":"TypeScript","readme":"# ![Coriolis Web](/src/components/ui/Logo/images/coriolis-small-black.svg)\n\nWeb GUI for [coriolis](https://github.com/cloudbase/coriolis)\n\n[![Build and Test](https://github.com/cloudbase/coriolis-web/actions/workflows/build.yml/badge.svg)](https://github.com/cloudbase/coriolis-web/actions/workflows/build.yml) [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n\n## Install instructions\n\n- Install [Node 18](https://nodejs.org/en/download)\n- clone repo\n- run `corepack enable` for yarn 3 support\n- run `yarn install` (development deps) or `yarn workspaces focus --all --production` (production deps)\n- set `CORIOLIS_URL` environment variable\n\n## Build instructions\n\nBuild the production version of the UI:\n\n- run `npm run build:prod`\n- run `npm run start` to start the server\n\nYour server will be running at `http://localhost:3000/` (the port is configurable through `PORT` environment variable)\n\n## Testing\n\n- unit tests can be run using `npm run test`\n- run `npm run test-release` to check for Typescript, ESLint and prettier errors. This will also run the unit tests and will try to build and start a production version. If eeverything is OK, it will revert to the development installation.\n\n### Integration tests\n\nIntegration tests can be executed using `npm run e2e`. All API calls will be mocked, eliminating the need for a running Coriolis instance.\n\nTo run the integration tests, you must set the environment variable `NODE_ENV='development'`, then execute `npm run build:dev` and `npm run start`. It is also recommended to set `CORIOLIS_URL` to a non-existent URL (such as \u003chttps://invalidd.it/\u003e) to prevent the UI from attempting to connect to a Coriolis instance for CORS checks. Although Cypress is configured to mock API calls, if a valid URL is set, the UI will still attempt to connect to it for CORS checks.\n\nYou can also run the integration tests for easier debugging by using `npm run server-dev` and `npm run client-dev`, and by updating the `baseUrl` in `cypress.config.ts` to `\u003chttp://localhost:3001\u003e`. The variables `NODE_ENV` and `CORIOLIS_URL`, as described above, are still required. Subsequently, execute the tests using `npx cypress open`. This procedure allows you to update the source code and see the changes reflected in the UI without having to rebuild and restart the server. Additionally, the tests will automatically re-run when you save a test file.\n\n## Development mode\n\n- set env. variable `NODE_ENV='development'`\n- run `npm run client-dev` to start local development server (starts on port 3001)\n- run `npm run server-dev` to start the express server in development mode\n\nTo debug the client code using VS Code, simply run the project's launch configuration from the 'Run' menu (Ctrl+Shift+D).\nThe last 2 `npm run ...` commands must be running in the background.\n\nTo debug the Node server using VS Code, run `npm run server-debug` instead of `npm run server-dev`.\n\nYou can view some of the UIs components in the [Storybook](https://github.com/storybooks/storybook) by running `npm run storybook`\n\n## Modding\n\nThe UI can be modded externally using a `.json` modding file. A sample is available in the repo [`ui-mod-sample.json`](ui-mod-sample.json).\n\nThe path to the .json mod file needs to be set in `MOD_JSON` environment variable (ex.: `MOD_JSON=/usr/ui-mod.json`).\n\nAny provider logos can be replaced using local logo images. The local image file paths need to be absolute.\n\nYou can specify one logo, in which case it will be scaled to all sizes. You can also specify logos for just a couple of the sizes, in which case the closest size to the one required will be used. Open [`ui-mod-sample.json`](ui-mod-sample.json) for more details.\n\nAny option from [`config.ts`](config.ts) can be modified by adding the `config` field to the [`ui-mod-sample.json`](ui-mod-sample.json) file.\n\n## Environment variables\n\nAll environment variables can be set in a `.env` file created in the root directory.\n\nThe following is the list of environment variables and their default values:\n\n```(bash)\nNODE_ENV='production'\nCORIOLIS_URL='\u003cyour-coriolis-url\u003e'\nMOD_JSON='\u003cpath-to-json\u003e'\nCA_FINGERPRINT='\u003cpath to CA fingerprint file used by metal hub agent\u003e'\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudbase%2Fcoriolis-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudbase%2Fcoriolis-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudbase%2Fcoriolis-web/lists"}