3070cb7c39
* linter * Add markdown linter * add env * only check markdown * Add token * Update .github/workflows/test-suite.yml * Markdown linter * Exit code * Update script * rename * mdlint * Add an empty line after end of file * Testing disable * add text * update mdlint.sh * ori validator inclusion * Add config yml file * Remove MD041 and fix advanced-datadir file * FIx validator inclusion file conflict * Merge branch 'unstable' into markdown-linter * change files * Merge branch 'markdown-linter' of https://github.com/chong-he/lighthouse into markdown-linter * mdlint * Remove MD025 * Remove MD036 * Remove MD045 * Removr MD001 * Set MD028 to false * Remove MD024 * Remove MD055 * Remove MD029 * Remove MD040 * Set MD040 to false * Set MD033 to false * Set MD013 to false * Rearrange yml file * Update mdlint.sh and test * Test remove fix * Test with fix * Test with space * Fix summary indentation * Test mdlint.sh * Update mdlint.sh * Test * Update * Test fix * Test again * Fix * merge into check-code * Update scripts/mdlint.sh Co-authored-by: Mac L <mjladson@pm.me> * Update scripts/mdlint.sh Co-authored-by: Mac L <mjladson@pm.me> * Remove set -e * Add comment * Merge pull request #7 from chong-he/unstable Merge unstable to markdown branch * mdlint * Merge branch 'unstable' into markdown-linter * mdlint
2.5 KiB
📦 Installation
Siren runs on Linux, MacOS and Windows.
Version Requirement
The Siren app requires Lighthouse v3.5.1 or higher to function properly. These versions can be found on the releases page of the Lighthouse repository.
Pre-Built Electron Packages
There are pre-compiled electron packages for each operating systems which can be downloaded and executed. These can be found on the releases page of the Siren repository.
Simply download the package specific to your operating system and run it.
Building From Source
Requirements
Building from source requires Node v18 and yarn.
Building From Source
The electron app can be built from source by first cloning the repository and entering the directory:
git clone https://github.com/sigp/siren.git
cd siren
Once cloned, the electron app can be built and ran via the Makefile by:
make
alternatively it can be built via:
yarn
Once completed successfully the electron app can be run via:
yarn dev
Running In The Browser
Docker (Recommended)
Docker is the recommended way to run a webserver that hosts Siren and can be connected to via a web browser. We recommend this method as it establishes a production-grade web-server to host the application.
docker is required to be installed with the service running.
The docker image can be built and run via the Makefile by running:
make docker
Alternatively, to run with Docker, the image needs to be built. From the repository directory run:
docker build -t siren .
Then to run the image:
docker run --rm -ti --name siren -p 80:80 siren
This will open port 80 and allow your browser to connect. You can choose
another local port by modifying the command. For example -p 8000:80 will open
port 8000.
To view Siren, simply go to http://localhost in your web browser.
Development Server
A development server can also be built which will expose a local port 3000 via:
yarn start
Once executed, you can direct your web browser to the following URL to interact with the app:
http://localhost:3000
A production version of the app can be built via
yarn build
and then further hosted via a production web server.
Known Issues
If you experience any issues in running the UI please create an issue on the Lighthouse UI repository.