Troubleshooting

Caddy: Auth cookie is not used by other subdomains

This is caused by Caddy not adding the necessary headers when forwarding the login request to Organizr.

Using the "transparent" preset or manually adding the necessary headers solves the issue.

For example:

organizr.example.com {
  proxy / http://organizr.internal {
    transparent
  }
}

See: https://caddyserver.com/docs/proxy

Docker: Showing Update available even though up to date

Remove index.lockif it tells you to.
Restart container.

Forgot my Organizr account password

If you find yourself in the situation where you've forgotten the password to your Organizr account (ONLY if you have auth set to Org DB ONLY and NOT using Plex or Emby backend), and did not yet setup the PHPMailer Plugin to be able to reset your password, you can use the following instructions to configure the PHPMailer Plugin and regain the ability to reset your forgotten password.

If you do not have your own mail server to use, You can use Organizr's server... Click Me!

Open up the Organizr config file, /config/www/Dashboard/api/config/config.php, in a text editor and setup the PHPMailer settings like so, with your own SMTP Server information:

'PHPMAILER-enabled' => true,
'PHPMAILER-logo' => 'https://raw.githubusercontent.com/causefx/Organizr/v2-develop/plugins/images/organizr/logo-wide.png',
'PHPMAILER-smtpHost' => 'smtp.domain.com',
'PHPMAILER-smtpHostAuth' => true,
'PHPMAILER-smtpHostPassword' => 'NEEDSHASHEDPASSWORD',
'PHPMAILER-smtpHostPort' => '587',
'PHPMAILER-smtpHostSenderEmail' => 'smtp@organizr.app',
'PHPMAILER-smtpHostSenderName' => 'Organizr',
'PHPMAILER-smtpHostType' => 'tls',
'PHPMAILER-smtpHostUsername' => 'smtp@organizr.app',
'PHPMAILER-template' => 'light',
'PHPMAILER-verifyCert' => true

You will need to check with your e-mail provider for all of the correct settings for this to work with your e-mail account.

Make sure that, if the last line of the above code is the last line in the file, that there is NO comma at the end and that the new code is inside the PHP block, before the ending );.

For example, if you're appending the code to the end of your config file, it would end up looking like this:

'PHPMAILER-enabled' => true,
'PHPMAILER-logo' => 'https://raw.githubusercontent.com/causefx/Organizr/v2-develop/plugins/images/organizr/logo-wide.png',
'PHPMAILER-smtpHost' => 'smtp.domain.com',
'PHPMAILER-smtpHostAuth' => true,
'PHPMAILER-smtpHostPassword' => 'NEEDSHASHEDPASSWORD',
'PHPMAILER-smtpHostPort' => '587',
'PHPMAILER-smtpHostSenderEmail' => 'smtp@organizr.app',
'PHPMAILER-smtpHostSenderName' => 'Organizr',
'PHPMAILER-smtpHostType' => 'tls',
'PHPMAILER-smtpHostUsername' => 'smtp@organizr.app',
'PHPMAILER-template' => 'light',
'PHPMAILER-verifyCert' => true

);

You will need the hashed value of the password, so, to get hashed value for PHPMAILER-smtpHostPassword, you need to create a PHP file in root of Organizr, IE: /config/www/Dashboard/hash_password.php, and then put this code:

<?php
require_once 'api/functions.php';
echo encrypt('PASSWORDHERE');

Replacing PASSWORDHERE with your SMTP account password. Browse to the domain/system you're running Org on and hit that PHP file, IE: https://domain.com/hash_password.php, to get the hashed password.

If you do not want to create a php file, you can use Organizr's... Click Me!

Put the hashed password into the config.php file and then you SHOULD be able to recover/reset your Organizr account password.