Frequently asked questions

Answers for common GTChat setup and usage questions.

Docs

Installation and hosting

Does GTChat require a database?

GTChat stores accounts, rooms, configuration and other durable state in files. The system does not require Perl database modules.

Why does the installer stay locked?

Check that the installer key is at the project root and readable by the CGI user, or set GTCHAT_INSTALLER_SECRET in the server environment. Open the exact chat endpoint and enter the private secret.

Why does CGI return a server error?

Check the server's error log, the interpreter in the script shebang, execute permission, and the configured CGI handler and path. Check the runtime directories as the account that actually runs the CGI.

Why do messages arrive in batches?

Check the backend and reverse proxy for response buffering. The server manual explains the relevant Nginx settings. Reproduce with two independent test accounts and verify message arrival before changing timeouts.

Accounts and messages

Why can’t a new account sign in?

Check the activation method under Registration and the account's approval state. If an email confirmation is required, use the message or resend it from the relevant account administration view.

Can I leave a message for an offline member?

Yes. For registered participants, private conversations can receive messages while a recipient is offline and show them when the recipient returns.

Where can I find the smileys?

Use the smiley button next to the room composer. In profile settings you can control smiley display.