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.
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.