Recovering From An Inaccessible Install #

Inaccessible after upgrading #

Please contact our support team at [email protected] for guidance on issue resolution and/or possible version rollback.

SSL (HTTPS) Issues #

Please see the troubleshooting page about this here.

Blank White Page #

This occurs due to a Javascript error on the page while loading it. The most common cause of this is setting an incorrect domain name or that domain name not being synced properly (see below).

Incorrect Domain Name(s) set #

Login as root on the SynergyCP web server and then run these commands:

/scp/bin/scp-exec php_s php artisan setting:update --name=api_url --value="https://<YOUR_API_DOMAIN>"
/scp/bin/scp-exec php_s php artisan setting:update --name=admin_url --value="https://<YOUR_ADMIN_DOMAIN>"
/scp/bin/scp-exec php_s php artisan setting:update --name=client_url --value="https://<YOUR_CLIENT_DOMAIN>"

Make sure to change <YOUR_API_DOMAIN>, <YOUR_ADMIN_DOMAIN>, <YOUR_CLIENT_DOMAIN> to the correct domain name. If you don’t have HTTPS enabled, you’ll need to change “https” to “http” in the commands above.

ACLed out (“IP not authorized”) #

Login as root on the SynergyCP master app server and then execute:

/scp/bin/scp-exec php_s php artisan tinker

Once the Tinker shell has opened, paste this in:

$acl = App\Setting\Setting::query()->where('name', 'admin_acls')->first();
$acl->value = '';
$acl->save();
event(new App\Setting\Events\SettingChanged($acl));
exit

License Issues #

Login as root on the SynergyCP master app server and then execute:

/scp/bin/scp-exec php_s php artisan license:refresh

If you need to change the license key to a different one, run this command as root:

/scp/bin/scp-exec php_s php artisan license:activate --key=<your new license key>

WARNING: Ensure you include your license key in this command! Activation without a license key may break your installation.

Lost/Incorrect Admin Credentials #

First, make sure you’re accessing the administrative side of the panel. The client login page looks identical to the admin one. The domain name for the admin side usually starts with admin. unless you’ve configured it differently.

If you have lost your admin credentials, login as root on the SynergyCP master app server and then execute:

/scp/bin/scp-exec php_s php artisan tinker 

Then, replace the `ADMIN_*`` details in the first two lines of this command with your desired ones. This will replace the first admin in the database’s login with these login details, so we recommend visiting the User > Admins page to make sure everyone still has access after:

​$username = 'ADMIN_USERNAME';
$password = 'ADMIN_PASSWORD';

App\Admin\Admin::query()->limit(1)->update(['username' => $username, 'password' => app('App\HashService')->crypt($password)])