Install Neptune DXP - Open Edition on Linux

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. Open a Terminal on your Linux environment.

  3. Unzip the ZIP file to a location of your choice.

  4. cd into the unzipped folder.

  5. In the Terminal, run ./planet9-linux.

    Result: The folder containing the executable file, will now be populated with the files generated by the platform.

  6. 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. By default Neptune DXP - Open Edition runs on localhost at port 8080.

  2. Depending on your infrastructure, identify the IP or domain of the Linux environment where Neptune DXP - Open Edition runs.

  3. Make sure the IP or domain is accessible from the computer where you run your browser.

  4. Open your browser and go to http://<your_ip/domain>:8080.

    If the terminal 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.

  5. You can safely end your session using the keyboard shortcut CTRL + C in the Terminal.