Skip to content

Latest commit

 

History

History
53 lines (43 loc) · 3.28 KB

faq.md

File metadata and controls

53 lines (43 loc) · 3.28 KB
Raw

Frequently Asked Questions

Q: Where can I find server logs when running in Docker?

A: The log is in the container at /var/log/tinode.log. Attach to a running container with command

docker exec -it name-of-the-running-container /bin/bash

Then, for instance, see the log with tail -50 /var/log/tinode.log

If the container has stopped already, you can copy the log out of the container (saving it to ./tinode.log):

docker cp name-of-the-container:/var/log/tinode.log ./tinode.log

Alternatively, you can instruct the docker container to save the logs to a directory on the host by mapping a host directory to /var/log/ in the container. Add -v /where/to/save/logs:/var/log to the docker run command.

Q: How to setup FCM push notifications?

A: If you running the server directly:

  1. Create a project at https://console.firebase.google.com if you have not done so already.
  2. Follow instructions at https://cloud.google.com/iam/docs/creating-managing-service-account-keys to download the credentials file.
  3. Update the server config: "push" -> "name": "fcm" section of the tinode.conf file. Do ONE of the following:
  • Either enter the path to the downloaded credentials file into "credentials_file".
  • OR copy file contents to "credentials".
    Remove the other entry. I.e. if you have updated "credentials_file", remove "credentials" and vice versa.
  1. Update TinodeWeb config firebase-init.js: update messagingSenderId and messagingVapidKey. These values are obtained from the https://console.firebase.google.com/.
  2. Add google-services.json to Tindroid by following instructions at https://developers.google.com/android/guides/google-services-plugin.

If you are using the Docker image:

  1. Create a project at https://console.firebase.google.com if you have not done so already.
  2. Follow instructions at https://cloud.google.com/iam/docs/creating-managing-service-account-keys to download the credentials file.
  3. Follow instructions in the Docker README to enable push notifications.
  4. Add google-services.json to Tindroid by following instructions at https://developers.google.com/android/guides/google-services-plugin.

Q: How can new users be added to Tinode?

A: There are three ways to create accounts:

  • A user can create a new account using client-side UI.
  • A new account can be created manually using tn-cli (acc command).
  • If the user already exists in an external database, the Tinode account can be automatically created on the first login using the rest authenticator.

Q: How to create a root user?

A: The root access can be granted to a user only by executing a database query. First create or choose the user you want to promote to root then execute the query:

  • RethinkDB:
r.db("tinode").table("auth").get("basic:login-of-the-user-to-make-root").update({authLvl: 30})
  • MySQL:
UPDATE auth SET authlvl=30 WHERE uname='basic:login-of-the-user-to-make-root';

The test database has a stock user xena which has root access.