···24242525If you are on a mac install it with [Homebrew](https://brew.sh/)
26262727-```sh
2828-brew tap chiselstrike/tap
2929-brew install turso
3030-```
3131-3232-then run it locally with
3333-3434-```sh
3535-turso dev --db-file openstatus.db
3636-```
37273828Here is the official Turso
3929[installation guide](https://docs.turso.tech/reference/turso-cli)
40304141-4. Run the database migration
3131+4. Install Bun
3232+All the up to date information are on the official [Bun website](https://bun.sh/)
42334343-In the `packages/db` folder run
3434+4. Set up the dev environment
44354536```sh
4646-pnpm migrate
3737+ pnpm dx
4738```
4848-4949-5. Set up your .env file
5050-5151-from `apps/web` and `packages/db` you will find .env.example. Please create your
5252-own.
5353-5454-6. Start the web app locally
3939+5. Start the development server
55405641```sh
5757-pnpm dev
4242+ pnpm dev:web
5843```
59446060-> ๐ก If you are getting this error -
6161-> `ERROR run failed: error preparing engine: Invalid persistent task configuration: You have 15 persistent tasks but`turbo`is configured for concurrency of 10. Set --concurrency to at least 16`
6262-> Then `cd` into web directory and then start the web app
6363->
6464-> ```sh
6565-> cd apps/web
6666-> pnpm dev
6767-> ```
4545+6. Open your browser and navigate to [http://localhost:3000](http://localhost:3000)
-19
apps/docs/contributing/requirements.mdx
···6464To install brew, it is recommended to use brew.sh from
6565[https://brew.sh/](https://brew.sh/) and follow its instructions.
66666767-### Installing sqld
6868-6969-Once you have installed it and performed updates with
7070-`brew update --auto-update`, you can install "sqld" as follows:
7171-7272-```bash
7373-brew tap libsql/sqld
7474-brew install sqld-beta
7575-sqld --help
7676-```
7777-7878-> _Note: Please ensure to add sqld to you system PATH_
7979-8080-This will allow you to work with the local database without modifying the ".env"
8181-file.
8282-8383-Please note that these optional requirements are only necessary if you want to
8484-use a local database. Otherwise, you can continue with the rest of the
8585-configuration as mentioned previously.
86678768### Installing Turso
8869
+1-2
apps/docs/contributing/setup-env.mdx
···6677The `.env` file contains various environment variables that need to be properly
88configured for the application to work correctly. Below, I will explain how to
99-obtain the values for some of these variables, focusing on the section related
1010-to Cleark Auth.
99+obtain the values for some of these variables.
11101211## Setting up Resend for sending emails
1312
-64
apps/docs/contributing/setup.mdx
···11----
22-title: Setup
33----
44-55-Follow these steps for setup:
66-77-### Clone the repository
88-99-To get started, clone the OpenStatus repository by running the following command
1010-in your terminal or command prompt:
1111-1212-```bash
1313-git clone https://github.com/openstatusHQ/openstatus.git
1414-```
1515-1616-### Install dependencies
1717-1818-Once the repository is cloned, navigate to the `openstatus` directory using the
1919-command:
2020-2121-```bash
2222-cd openstatus
2323-```
2424-2525-Next, use pnpm to install the required dependencies. Execute the following
2626-command:
2727-2828-```bash
2929-pnpm install
3030-```
3131-3232-### Configure .env files
3333-3434-To configure the application, you need to set certain environment variables in a
3535-`.env` file. You will find an example file named `.env.example` in the
3636-`apps/web` and `packages/db` directories. Copy this file and rename it to
3737-`.env`. Then, edit the `.env` file with specific values required for your
3838-configuration.
3939-4040-You can use any text editor, or manually copy it into an empty .env file or
4141-whatever you want to do.
4242-4343-For example, you can use a text editor (nano) to open the `.env` file:
4444-4545-```bash
4646-# apps/web
4747-cp apps/web/.env.example apps/web/.env
4848-nano apps/web/.env
4949-5050-# packages/db
5151-cp packages/db/.env.example packages/db/.env
5252-nano packages/db/.env
5353-```
5454-5555-Make sure to provide appropriate values for each variable defined in the `.env`
5656-file. These variables may include configurations related to the database, API
5757-credentials, etc.
5858-5959-โ ๏ธ Keep in mind that the `.env` file should be kept **private** and should not
6060-be shared publicly as it may contain sensitive information such as passwords or
6161-access keys.
6262-6363-Once you have completed these steps, you will have finished the setup and
6464-configuration of OpenStatus, and you'll be ready to start the application.
···33description: "How does OpenStatus' synthetic monitoring work?"
44---
5566-With our synthetic monitoring, you can track the availability and performance of
66+With our synthetic monitoring, you can monitor the availability and performance of
77your website or API from various global locations.
8899We will monitor your website or API on a regular schedule and record the