Skip to main content
Version: 3.0.0-LTS

Mac OS

The following guide is intended for contributors to set-up ToolJet locally. If you're interested in self-hosting ToolJet, please refer to the Setup section.

To set up and run ToolJet on macOS for development, begin by opening your terminal and executing the commands listed below. For a better understanding of ToolJet's framework, we advise reviewing our architecture guide before proceeding.

Setting up

  1. 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: v18.18.2 ) and npm (version: v9.8.1)

    brew install nvm
    export NVM_DIR=~/.nvm
    source $(brew --prefix nvm)/nvm.sh
    nvm install 18.18.2
    nvm use 18.18.2
    npm install -g [email protected]

    1.3 Install Postgres

    tip

    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@13

    1.4 Install PostgREST(optional)

    info

    Required only if ToolJet Database is being used.

    brew install postgrest

    1.5 Fork the repository:

    Go to the ToolJet GitHub repository, click on the Fork button to create a copy of the repository under your own GitHub account.

    1.6 Clone your forked repository:

    After forking, clone the forked repository to your local machine using the URL of your forked repo.

    git clone https://github.com/<your-username>/ToolJet.git
  2. 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
  3. Populate the keys in the env file

    info

    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=localhost
    PG_PORT=5432
    PG_USER=postgres
    PG_PASS=postgres
    PG_DB=tooljet_development
    ORM_LOGGING=all
  4. Install and build dependencies

    npm install
    npm install --prefix server
    npm install --prefix frontend
    npm run build:plugins
  5. Set up database

    npm run --prefix server db:create
    npm run --prefix server db:reset
    info

    If at any point you need to reset the database, use this command npm run --prefix server db:reset

  6. Run plugins compilation in watch mode

    cd ./plugins && npm start
  7. Run the server

    cd ./server && npm run start:dev
  8. Run the client

    cd ./frontend && npm start

    The client will start on the port 8082, you can access the client by visiting: http://localhost:8082

  9. Create login credentials

    Visiting http://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>