Difference between revisions of "Installation:website"
From PrometheusIPN Wiki
(Fixed grammatical issues, and expanded on previous information regarding installation ^Tristan) |
|||
| Line 7: | Line 7: | ||
* Extract the contents of the "Web files" folder to your web server | * Extract the contents of the "Web files" folder to your web server | ||
| − | * Edit the file config.php | + | * Create a MySQL database and user using your website's control panel. Make sure to give the user read/write/execute access to the database. |
| − | + | * Edit the file config.php that you have uploaded and fill in the MySQL database and user information from step 2. (for the host, typically you can leave it as 'localhost' and port '3306') | |
| − | * | + | * After you have modified your config.php file, navigate to yourwebsite.com/install.php. Here, you will see something similar to this: |
<br><br> | <br><br> | ||
[[File:Web1.png|900px]] | [[File:Web1.png|900px]] | ||
| − | <br> | + | <br><br> |
The three last fields will be automatically filled in and the other ones are pretty self explanatory. | The three last fields will be automatically filled in and the other ones are pretty self explanatory. | ||
| − | The next step is for Linux only Make sure to set the right permissions for your files! | + | ====== Extra Steps for Linux Installations ====== |
| − | This can be done by running these commands in a | + | |
| + | The next step is for Linux only. Make sure to set the right permissions for your files! This can be done by running these commands in a Linux terminal: | ||
cd path/to/installdir | cd path/to/installdir | ||
| Line 25: | Line 26: | ||
===== BLANK PAGE ===== | ===== BLANK PAGE ===== | ||
| + | If you are encountering an issue with the page being blank or your web browser stating an 'Internal Error 500', please follow the below guide in order to fix it: | ||
====== Windows ====== | ====== Windows ====== | ||
The next step is for Windows only! | The next step is for Windows only! | ||
* Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory | * Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory | ||
| + | * If you are having error 500 and have already allowed IIS_USRS access, please make sure to also grant IUSR access. | ||
====== Linux ====== | ====== Linux ====== | ||
* Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions ''recursively'' | * Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions ''recursively'' | ||
| − | * | + | * Alternatively, you can also just run the SSH command ''sudo chmod 0777 cache/* ''whilst in the Prometheus directory. |
| + | |||
'''Both''' | '''Both''' | ||
| − | If the blank page issue persists, please find a PHP error log and submit a ticket over at [[nmscripts.com]] with | + | If the blank page issue persists, please find a PHP error log and submit a ticket over at [[nmscripts.com]] with your host's PHP error log (found on your website's control panel typically). It's likely that you are missing a dependency. |
| + | |||
| + | When you have completed the installation you can now visit yourwebsite.com and click 'Sign In' from the menu. The first user that signs in is the one that will get root admin permission, so please make sure to sign in quickly to make sure you don't get locked out. | ||
| − | + | ===== Optional Steps ===== | |
| + | You may complete the following additional tasks to extend your Prometheus installation's capabilities: | ||
| + | * You can set your /img folder to have read/write permissions (CHMOD 0777) to allow you to upload files directly when configuring packages and servers. | ||
| + | * If you include a Steam API key in your config.php file, it will be used as a fallback in case Steam authorization fails. This is recommended. | ||
Revision as of 21:30, 7 June 2016
Contents
Video tutorial
WEBSITE INSTALLATION
The web installation is pretty straight forward.
- Extract the contents of the "Web files" folder to your web server
- Create a MySQL database and user using your website's control panel. Make sure to give the user read/write/execute access to the database.
- Edit the file config.php that you have uploaded and fill in the MySQL database and user information from step 2. (for the host, typically you can leave it as 'localhost' and port '3306')
- After you have modified your config.php file, navigate to yourwebsite.com/install.php. Here, you will see something similar to this:
The three last fields will be automatically filled in and the other ones are pretty self explanatory.
Extra Steps for Linux Installations
The next step is for Linux only. Make sure to set the right permissions for your files! This can be done by running these commands in a Linux terminal:
cd path/to/installdir sudo chown www-data:www-data install.php img/pkgs updates themes sudo chmod 775 install.php cert/* ipn_errors.log img/pkgs updates sudo chmod 0777 cache/* themes
BLANK PAGE
If you are encountering an issue with the page being blank or your web browser stating an 'Internal Error 500', please follow the below guide in order to fix it:
Windows
The next step is for Windows only!
- Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory
- If you are having error 500 and have already allowed IIS_USRS access, please make sure to also grant IUSR access.
Linux
- Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions recursively
- Alternatively, you can also just run the SSH command sudo chmod 0777 cache/* whilst in the Prometheus directory.
Both
If the blank page issue persists, please find a PHP error log and submit a ticket over at nmscripts.com with your host's PHP error log (found on your website's control panel typically). It's likely that you are missing a dependency.
When you have completed the installation you can now visit yourwebsite.com and click 'Sign In' from the menu. The first user that signs in is the one that will get root admin permission, so please make sure to sign in quickly to make sure you don't get locked out.
Optional Steps
You may complete the following additional tasks to extend your Prometheus installation's capabilities:
- You can set your /img folder to have read/write permissions (CHMOD 0777) to allow you to upload files directly when configuring packages and servers.
- If you include a Steam API key in your config.php file, it will be used as a fallback in case Steam authorization fails. This is recommended.
