Install Neptune DXP - Open Edition on macOS

This installation procedure describes the basic minimum steps required to run Neptune DXP - Open Edition locally for nonproductive purposes.

Data loss

By default, all data is stored locally using SQLite.

If you delete the installation folder, your data will be lost and cannot be recovered.

We recommend the following:

  • Use SQLite only for temporary testing or evaluations.

  • Back up the SQLite folder regularly.

  • Use a dedicated database, for example, PostgreSQL, or MySQL, for anything beyond short-term evaluation from the start of development. This will avoid any migration efforts later on.

For more information, see Database configuration for Neptune DXP - Open Edition.

  1. Download the latest version of Neptune DXP - Open Edition from the product download section on Neptune DXP Portal.

  2. Unzip the ZIP file.

  3. Right-click the unzipped folder and select Services → New Terminal at Folder.

  4. In the terminal, run ./planet9-darwin.

    Result: A macOS notification displays that the planet9-darwin file cannot be opened.

  5. In the macOS notification showing that the planet9-darwin file cannot be opened, select Done.

  6. Go to System Settings → Privacy & Security.

  7. In the Security section, you will find a notification that the planet9-darwin file was blocked from use.

  8. Select Allow Anyway.

  9. In the terminal, run ./planet9-darwin again.

    Result: A macOS notification prompts you to confirm you want to open the planet9-darwin file.

  10. Select Open Anyway.

    Result: A macOS notification prompts you to approve opening the file by either approving with an administrator Touch ID or entering an administrator’s password.

  11. In the terminal, run ./planet9-darwin again.

    Result: The folder containing the executable file populates with the files generated by the platform.

  12. Check in your installation folder that the following additional folders were added: db, webapp, config, and log.

Open Neptune DXP - Open Edition in your browser

  1. Open your browser and go to http://localhost:8080.

    If the command line interface is closed, the node session will be terminated, and you will lose access to the platform via the browser.

    1. The default username is admin.

    2. The default password is admin.

  2. You can safely end your session using the keyboard shortcut CMD + C in the terminal.

Next steps

Related topics