版本：v2.0.0

Mac OS

Follow these steps to setup and run ToolJet on macOS for development purposes. Open terminal and run the commands below. We recommend reading our guide on architecture of ToolJet before proceeding.

Setting up

Set up the environment
1.1 Install Homebrew
```
/bin/bash -c "(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
```
1.2 Install Node.js ( version: v14.17.3 ) and npm (version: v7.20.0)
```
brew install nvm
export NVM_DIR=~/.nvm
source $(brew --prefix nvm)/nvm.sh
nvm install 14.17.3
nvm use 14.17.3
npm install -g npm@7.20.0
```
1.3 Install Postgres
提示
ToolJet uses a postgres database as the persistent storage for storing data related to users and apps. We do not plan to support other databases such as MySQL.
```
brew install postgresql
```
1.4 Install PostgREST(optional)
信息
Required only if Tooljet Database is being used.
Please use PostgREST version 10.1.1.x
```
brew install postgrest --version 10.1.1.20221215
```
1.5 Clone the repository
```
git clone https://github.com/tooljet/tooljet.git
```
Set up environment variables
Create a .env file by copying .env.example. More information on the variables that can be set is given in the environment variables reference
```
cp .env.example .env
```

Populate the keys in the env file

信息

SECRET_KEY_BASE requires a 64 byte key. (If you have openssl installed, run openssl rand -hex 64 to create a 64 byte secure random key)

LOCKBOX_MASTER_KEY requires a 32 byte key. (Run openssl rand -hex 32 to create a 32 byte secure random key)

Example:

cat .env
TOOLJET_HOST=http://localhost:8082
LOCKBOX_MASTER_KEY=1d291a926ddfd221205a23adb4cc1db66cb9fcaf28d97c8c1950e3538e3b9281
SECRET_KEY_BASE=4229d5774cfe7f60e75d6b3bf3a1dbb054a696b6d21b6d5de7b73291899797a222265e12c0a8e8d844f83ebacdf9a67ec42584edf1c2b23e1e7813f8a3339041
NODE_ENV=development
# DATABASE CONFIG
PG_HOST=postgres
PG_PORT=5432
PG_USER=postgres
PG_PASS=postgres
PG_DB=tooljet_development
ORM_LOGGING=all

Install and build dependencies

npm install
npm install --prefix server
npm install --prefix frontend
npm run build:plugins

Set up database
```
npm run --prefix server db:reset
```
Run plugins compilation in watch mode
```
cd ./plugins && npm start
```
Run the server
```
cd ./server && npm run start:dev
```
Run the client
```
cd ./frontend && npm start
```
The client will start on the port 8082, you can access the client by visiting: https://localhost:8082
Create login credentials
Visiting https://localhost:8082 should redirect you to the login page, click on the signup link and enter your email. The emails sent by the server in development environment are captured and are opened in your default browser. Click the invitation link in the email preview to setup the account.

Running tests

Test config requires the presence of .env.test file at the root of the project.

To run the unit tests

npm run --prefix server test

To run e2e tests

npm run --prefix server test:e2e

To run a specific unit test

npm run --prefix server test <path-to-file>

Mac OS

Setting up​

Running tests​

Setting up

Running tests