TNG Installation Instructions

Single-page guide (show everything at once) | Hide all

TNG Support:
TNG Forum:
TNG Wiki:
TNG info:
PHP info:
MySQL info:

Product Updates:
User Discussion:

Discussion List Options
Discussion List Archives
  • Welcome to the TNG installation guide!

    IMPORTANT: This is the FULL INSTALLATION guide. If you are upgrading an existing installation, please exit this page immediately and refer instead to the readme file that came with your upgrade!

    Begin Here

    Please complete these steps IN ORDER. If you stop part way and come back later, you can start again where you left off (if you start over from the beginning and permissions cannot be set on some files, that's OK). If you have questions, or if anything refuses to work, please look over at the corresponding steps in the More Information section.

    1. Upload or copy all files and folders from the TNG zip file to the location on your web site where you plan to run TNG. This can be the root folder or any subfolder (Note: The "root" folder is where your home page lives. It may be named "public_html" or "www".

    2. If you were viewing this guide on your home computer, close the page now and browse to it on your website instead (for example, ""). Use a browser, not an FTP program! If you need to view this page in another language, you will see an option for that when you view it from your site.

    3. Set permissions:
      Some files and folders need to be made writeable. If you've done this before and have already completed step 4 below, you may see a message saying that the permissions on those folders can't be renamed. That's OK. :)

    4. Rename two folders:
      For security reasons, we recommend you choose different names for the GEDCOM and Backups folders. If you've completed this step before, you'll get an error here. Don't worry, just keep going.
      Backups Folder:
      GEDCOM Folder:

    5. Choose your language and character set:
      If the choices you see are what you want, then you don't need to do anything here. If your language includes a lot of special characters, choose the UTF-8 variant.


    6. Establish a connection to your database:
      If you don't know this information, ask your web host. They may want you to create the database yourself, but they can show you how. Most people will not need to enter anything for the Port or Socket.

      Host Name:
      Database Name:
      Database Username:
      Database Password:
      Database Port: (leave blank for default)
      Database Socket: (leave blank for default)

    7. Create the database tables:
      This uses default table names with a "tng_" prefix. To use custom names, create the tables from the More Information section. If you're using UTF-8 as your character set, you should set the collation to utf8_general_ci, utf8_unicode_ci or similar. If you're not using UTF-8, latin_swedish_ci is a common choice. If you're not sure, look here, or blank out the box below to use the default assigned to your database by your host.

      Database Collation: (leave blank to use your database's default collation)

    8. Create a user for yourself:
      All fields are required. More information about this user can be entered later.

      Password again:
      Your real name:
      Your email:

    9. Create a "tree" (a container) for your genealogy:
      Both fields are required. More information about this tree can be entered later. You can create more trees later if necessary.

      Tree ID: (should be short, alphanumeric only, no spaces)
      Tree Name:

    10. Select a template (or theme):
      This is optional (if you like plain vanilla or plan to build your own design from scratch). Otherwise, see the choices at You may change the template again later from Admin/Setup/Template Settings.

      Template Number:

    TNG is now installed and ready to use! Before you dive in, you might benefit by visiting the More Information section and reviewing the following topics:

    You might also want to read the Getting Started articles on the TNG Wiki for additional information.

    > Go to your home page

    > Go to the Admin menu