Difference between revisions of "ProxCP Installation"
From ProxCP Documentation
Line 16: | Line 16: | ||
== 2. Daemon Installation == | == 2. Daemon Installation == | ||
− | + | * Ensure your daemon server meets the ProxCP Daemon minimum requirements | |
+ | * Download the latest version of ProxCP Daemon from your [https://my.proxcp.com My ProxCP] account | ||
+ | * Upload the zip file to your daemon server; ensure the upload destination is not web-accessible (i.e. do not place the daemon in /var/www/html) | ||
+ | * Extract the zip file in this directory; delete the zip file | ||
+ | * Copy/paste your ProxCP license key into the LICENSE.key file | ||
+ | * Copy/move your SSL certificate files into the keys/ directory. Files must be named exactly as follows: | ||
+ | ** ca.crt - Intermediate Certificate Authority | ||
+ | ** domain.crt - Your SSL certificate | ||
+ | ** domain.key - Your private key | ||
+ | ** If you do not already have a SSL certificate for ProxCP daemon, you can get a free certificate from [https://letsencrypt.org/ Let's Encrypt] (just make sure to renew it on time) ([https://github.com/Neilpang/acme.sh Let's Encrypt CLI Tool]) | ||
+ | * Edit the config.js file for appropriate settings. The comments in the file thoroughly explain each setting. The MySQL database used by ProxCP Web and ProxCP Daemon should be the same. You will need to paste the ProxCP Daemon Key from the ProxCP Web installer into this file. | ||
+ | * That's it, you're done! Run the proxcp-socket executable (recommended to run in a "screen" session or as a background process) |
Revision as of 18:04, 11 December 2018
1. Web Application Installation
- Ensure your web server meets the ProxCP minimum requirements
- It is highly recommended to use HTTPS with ProxCP however it is not a requirement
- Download the latest version of ProxCP from your My ProxCP account
- Upload the zip file to your web server's service directory (i.e. /var/www/html)
- Extract the zip file in this directory; delete the zip file
- Navigate your browser to https://[your ProxCP domain]/install
- The ProxCP web installer has 4 steps and completes in minutes. Step 1: Review and agree to the License Agreement
- Step 2: Review ProxCP requirements and make adjustments as needed
- Step 3: Enter your MySQL database settings, default Administrator credentials, license key, and the domain/port combination that ProxCP Daemon will run on (i.e. https://app.domain.com:8000)
- The ProxCP Daemon does require HTTPS connections and will not work over HTTP
- Step 4: The installer will complete and provide further security steps and a ProxCP Daemon Key. This key is required during ProxCP Daemon installation (DO NOT share or lose this key)
- You will then be redirected to the ProxCP login page where initial configuration can continue
2. Daemon Installation
- Ensure your daemon server meets the ProxCP Daemon minimum requirements
- Download the latest version of ProxCP Daemon from your My ProxCP account
- Upload the zip file to your daemon server; ensure the upload destination is not web-accessible (i.e. do not place the daemon in /var/www/html)
- Extract the zip file in this directory; delete the zip file
- Copy/paste your ProxCP license key into the LICENSE.key file
- Copy/move your SSL certificate files into the keys/ directory. Files must be named exactly as follows:
- ca.crt - Intermediate Certificate Authority
- domain.crt - Your SSL certificate
- domain.key - Your private key
- If you do not already have a SSL certificate for ProxCP daemon, you can get a free certificate from Let's Encrypt (just make sure to renew it on time) (Let's Encrypt CLI Tool)
- Edit the config.js file for appropriate settings. The comments in the file thoroughly explain each setting. The MySQL database used by ProxCP Web and ProxCP Daemon should be the same. You will need to paste the ProxCP Daemon Key from the ProxCP Web installer into this file.
- That's it, you're done! Run the proxcp-socket executable (recommended to run in a "screen" session or as a background process)