nuBuilder Installation Guide - nuBuilder/nuBuilder GitHub Wiki

nuBuilder Requirements

To run nuBuilder, you need the following:

  • Database: MySQL 5.7 (or greater) OR MariaDB 10.3 (or greater)
  • Web Server: Apache, Nginx, or any other web server that supports PHP.
  • PHP: Version 7.0.33 or newer.

Advice: Using a local server (hosted on your own machine) allows you to test your website thoroughly before deploying it to a live web server. This saves time and simplifies the development process. Popular packages for different platforms include:

If you intend for your nuBuilder site to send emails, you will also need access to an SMTP server.

Installation Steps

1. Download nuBuilder

Download the nuBuilder files from one of the following sources:

2. Unpack Files

Unpack the downloaded files into a directory on your server (e.g., your-web-root/nubuilder).

3. Create a Database

Create a new MySQL or MariaDB database.

  • Use a tool like phpMyAdmin or another application provided by your hosting provider.
  • Assign a name, username, and password to the database. The database name can be anything (e.g., nubuilder4).
  • For detailed instructions, you can refer to guides like Create MySQL Database & User via phpMyAdmin.

4. Configure nuconfig.php

a. In your nuBuilder directory, find the file nuconfig-sample.php. b. Make a copy of this file and rename the copy to nuconfig.php.

5. Update Settings in nuconfig.php

Edit nuconfig.php and update the following database connection variables:

  • nuConfigDBHost: The hostname or IP address of your database server (e.g., "127.0.0.1" or "localhost").
  • nuConfigDBName: The name of the database you created (e.g., "nubuilder4").
  • nuConfigDBUser: The username for accessing the database (e.g., "root").
  • nuConfigDBPassword: The password for the database user.
  • nuConfigDBGlobeadminUsername: The desired username for the nuBuilder super administrator (e.g., "globeadmin").
  • nuConfigDBGlobeadminPassword: The password for the nuBuilder super administrator.

Example:

$nuConfigDBHost                = "127.0.0.1";    // -- Use an IP address or server name e.g., 127.0.0.1 or localhost
$nuConfigDBName                = "nubuilder4";   // -- Database name
$nuConfigDBUser                = "your_db_user"; // -- Database username
$nuConfigDBPassword            = "your_db_password"; // -- Database password
$nuConfigDBGlobeadminUsername  = "globeadmin";   // -- globeadmin username
$nuConfigDBGlobeadminPassword  = "notpassword";  // -- globeadmin password

As a best practice, please create a new MySQL user and do not use root!

6. (Optional) Settings under Linux (sometimes also under Windows)

Edit the file /etc/alternatives/my.cnf and add this configuration at the bottom:

[client]
port=3306
socket=/tmp/mysql.sock

[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=8M
sql-mode=NO_ENGINE_SUBSTITUTION

[mysqldump]
quick

7. Log in

After you have completed these steps you should be able to go to a URL that will look something like the following: http://yoursitename.com/nubuilder4/index.php

Log in using globeadmin as the user-name and the password you specified.

8. Setup inside nuBuilder

Click the Setup Button on the Setup Tab of the Home Form to edit the following...

Timeout Time Zone

Language: Set the language for the globeadmin user.

Email Settings Header The Header is placed in the HTML5 header of nuBuilder Forte and can be used for adding...

  • JavaScript libraries
  • JavaScript functions
  • Style Sheets

Style

  • CSS Styles

Settings

Various configuration settings

9. Next steps

Read the nuBuilder Forte User Guide (see link below), join the Forums to search for answers or ask questions.

Useful links: