To jump-start your installation of OpenCAD on your web host, head to the OpenCAD website or directly to the Github Repo to grab the latest release. At the time of this document, the latest release is version 0.3.2, therefore we will be utilizing this in our examples.
Once you have the .zip folder downloaded to an easily accessible directory, proceed to your web host service by entering cPanel and navigating to the "public_html" directory. Typically the upload is completed by uploading the .zip folder and extracting the contents. We recommend doing this as well to prevent upload issues. Extract the files then navigate to the newly created folder. Select all of the contents and move them to the public_html directory. The SQL folder will be utilized in a later portion of the walkthrough, but it is recommended to use the SQL files from the download stored on your computer.
Now that you have uploaded a significant portion of OpenCAD, head back out to your cPanel and configure a database user, utilizing the wizard tool. Ensure this user has the full permissions to access the database. Keep track of these credentials! You will need them in the OpenCAD Installation Wizard.
Navigate to the installation wizard by going to your domain and adding “/oc-install/start.php” to the end of the URL. As an example, navigate in a new tab to
http://www.yourdomain.com/oc-install/start.php This will initialize the Installation wizard for OpenCAD. Follow the steps to get started and heed all warnings.
The first step in this installation process is connecting OpenCAD to your created database. Recall the credentials utilized above when starting the database and fill out the appropriate fields. Note the Database Prefix field is automatically filled in. DO NOT CHANGE IT. Keep note of this for the next step.
Do NOT press “test connection” - this will endlessly spin.
THERE HAS BEEN A FILE PATH UPDATE! YOU NOW HAVE SELECTIONS FOR DIFFERENT GAMES.
Before importing your SQL files to your database, we will need to do some editing. Open the file oc_GTAV_data.sql in a text editor and perform a Find + Replace search for <DB_PREFIX> to replace that phrase with your database prefix as found in the prior step.
Make sure you change all of them and SAVE the files!
You will need to repeat these steps for the oc_install.sql and oc_update.sql files as well.
Upload the “oc_install.sql” and “oc_GTAV_data.sql” files to your database.
The “oc_update.sql” file is only used for updating. Keep this file around in the event you need to perform an update down the road.
Now that you can connect to your database, the wizard is establishing the “owner” account to log in. Make sure that you have access to the email you use and that you remember the credentials you configure - there is no reset function written in yet! (If you forget your password, you will have to do a fresh install again.)
In this section, you will be setting up core settings for your community.
Community Name - the name of your roleplay community!
Application URL - the URL of your installation.
Valid Examples include:
The OpenCAD team does not recommend including the trailing / on any of the above examples. It won't necessarily break anything but just makes reference look strange having two slashed when it isn't needed.
CAD From Email - the email address for outbound emails from the application.
CAD To Email - the email address for inbound emails to the application.
This section configures what the three core departments have access to. All of these True/False toggles determine what is visible in the MDT for each department.
Similar to Department Settings, this section governs permissions for Civilians.
Control what moderators are allowed to do and see within the application.
At this point, the installation wizard has enough data to create the necessary content as you have provided. Press continue to run the installation.
Follow the advisory direction of removing the oc-install folder from your server.
Congrats! Log into your application!