Installing Nova
Get up and running with Nova 3 in just a few minutes
To get started, you’ll need to upload Nova’s files to your server. You do this using:
- An FTP client (recommended for speed and ease of use), or
- Your hosting provider’s web-based server management tool, such as cPanel or Plesk.
If you’re unsure how to connect to your server or upload files, reach out to your web hosting provider for assistance. They’ll be able to guide you through the process.
Updating the document root
What is a document root?
The document root is the main folder on a web server where it stores the files that visitors see when they access your website. For example, when someone visits https://example.com, the web server looks in the document root to find the file or page to display.
On many shared hosting services, the document root is a folder named public_html. Any files you place inside public_html can be accessed through a web browser. Files outside of public_html are hidden from visitors, which is useful for keeping sensitive information secure.
Why does this matter for Nova 3?
Nova 3 has been designed with a secure file structure that separates the parts of your application that visitors can access from the parts they cannot. This structure ensures that sensitive files, such as configuration details or database settings, are stored safely out of reach from web browsers.
To make this work, Nova 3 uses a public folder as the document root. This folder contains only the files that need to be visible to the public, like images, JavaScript, and the main entry point for the application (index.php).
If you are installing Nova 3 or upgrading from Nova 2, you’ll need to update your web server’s document root to point to the public folder instead of the default document root (likely public_html). This small change helps protect your site and keeps sensitive files hidden from prying eyes.
Updating the document root in cPanel
Updating the document root in cPanel
If your host provides cPanel for managing your site, you can set the document root for your website to point to Nova’s /public folder with the following steps:
- Log in to cPanel and find the Domains section
- Click on Domains or Addon Domains, depending on whether you are modifying the primary domain or an additional domain
- Find the domain you want to update in the list of domains and click on the Manage option
- In the document root field, update the path to include the
/publicfolder. For example:- If the current root is
/home/username/public_html, change it to/home/username/public_html/public. - For addon domains, it might look like
/home/username/addon_domain/public.
- If the current root is
- Save your changes
Updating the document root in Plesk
Updating the document root in Plesk
If your host provides Plesk for managing your site, you can set the document root for your website to point to Nova’s /public folder with the following steps:
- Log in to cPanel and find the Websites & Domains section
- Find the domain you want to update and click on the Hosting Settings option
- In the document root field, update the path to include the
/publicfolder. For example:- If the current root is
/home/username/public_html, change it to/home/username/public_html/public. - For subdomains, it might look like
/home/username/subdomain/public.
- If the current root is
- Save your changes
Installing Nova
To start installing Nova, open your browser and navigate to your website. If Nova isn’t installed yet, it will automatically detect this and redirect you to the Setup Center to guide you through the installation process.
Verify Nova can run on your server
The first step in the installation process is to ensure your server meets all the requirements to run Nova 3. During setup, the system will perform a compatibility check and display the results on the first screen.
If any checks fail, you’ll see detailed information about what needs to be fixed. Work with your hosting provider to address these issues before proceeding with the installation. Once everything meets the requirements, you can continue the setup process.
Connect to your database
Nova includes a user-friendly, web-based tool to help you set up your database connection. During the setup process, you’ll be prompted to enter the database credentials provided by your web host when you set up your account. Nova will use these credentials to test the connection. If the connection is successful, Nova will automatically configure the necessary settings for you.
If your server doesn’t allow web scripts to create files, the setup process will guide you with clear instructions on how to manually add the database credentials to the appropriate configuration file.
Install Nova
Once you’ve finished connecting to your database, you’ll be able to start by doing a fresh install of Nova 3 after entering the name of your game and selecting the genre that you want installed.
At this point, you can either choose to continue with a fresh install or migrate your existing Nova 2 data. If you want to migrate from Nova 2, you should follow the Nova 2 migration guide. If you are installing Nova 3 fresh, there’s one more step.
Setup user accaount
The final step of installing Nova is to create your user account. Once you have entered your user account details, your account will be created, access roles will be assigned, and you will be signed in to Nova.
Congrats! You’ve installed Nova 3 and are on your way.