Skip to main content

Install the Web Platform

This guide covers how to download, configure, and run the SIMPLE web platform.

Download the Platform​

  1. Go to the SIMPLE web platform repository
  2. Click on "Releases" in the right sidebar
  3. Download the latest stable release ZIP file

Option 2: Direct Download​

  1. Go to the repository homepage
  2. Click the green "Code" button
  3. Select "Download ZIP"
warning

Ensure the "main" branch is selected before downloading

Configure Environment Variables​

  1. Copy the example environment file:
macOS / Linux
cp .env.example .env
Windows
copy .env.example .env
  1. Edit the .env file with your settings
tip

For detailed information about all environment variables, see the .env reference

Install Dependencies​

npm install

This may take a few minutes depending on your network speed.

Start the Application​

Prerequisite

Ensure GAMA is open and running before starting the web platform.

npm start

The application will start and display the URL in your terminal (default: http://localhost:8000).

Access the Platform​

Open your web browser and navigate to the URL shown in your terminal.

Troubleshooting​

  • Port 8000 in use? Change WEB_APPLICATION_PORT in .env
  • Can't connect to GAMA? Verify GAMA is running and check GAMA_IP_ADDRESS and GAMA_WS_PORT settings

Next Steps​