From 790ee9977a587d89c2f38263b539c3c3d9cbc608 Mon Sep 17 00:00:00 2001 From: Zachary Klosko Date: Tue, 24 Nov 2020 09:56:53 -0500 Subject: [PATCH] Adding in How to Change Default Passwords --- docs/_docs/default-passwords.md | 71 ++++++++++++++++++++++++++++++++ docs/_docs/host-configuration.md | 42 ------------------- 2 files changed, 71 insertions(+), 42 deletions(-) create mode 100644 docs/_docs/default-passwords.md diff --git a/docs/_docs/default-passwords.md b/docs/_docs/default-passwords.md new file mode 100644 index 000000000..c3b87df8c --- /dev/null +++ b/docs/_docs/default-passwords.md @@ -0,0 +1,71 @@ +--- +title: How To Change Default Passwords +layout: article +category: admin +--- + +### Libretime + +To change the password of the current user: + +1. Log in to Libretime +2. Click on the username in the upper right corner (next to Log Out) +3. Enter the new password twice and click **Save** + +To change the password for a different user (requires *Administrator* privileges): + +1. Log in to Libretime +2. Go to **Settings** > **Manage Users** +3. Select the user, enter the new password twice, and click **Save** + +### PostgreSQL + +Two of the most important passwords that should be changed *immediately* after installation +are the passwords used by the PostgreSQL database. +It is strongly recommended that you do this before exposing your server to the internet beyond your internal network. + +1. Login to PostgreSQL with `sudo -u postgres psql`. The PostgreSQL shell - `postgres=#` - means that you have logged in successfully. +2. Change the admin password with `ALTER USER postgres PASSWORD 'myPassword';`, where `myPassword` is the new password. +Make sure to include the semicolon at the end! A response of `ALTER ROLE` means that the command ran successfully. +3. Change the password for the *airtime* user with `ALTER USER airtime WITH PASSWORD 'new_password';` +A response of `ALTER ROLE` means that the command ran successfully. +4. If all is successful, logout of PostgreSQL with `\q`, go back to */etc/airtime/airtime.conf* to edit the password +in the config file, and restart all services mentioned in the previous section. + +### Icecast + +Random passwords are generated for Icecast during the installation. To look up and change the passwords, look in the file below. + +`/etc/icecast2/icecast.xml` + +Replace the admin and *changeme* fields below. + +``` + + + changeme + + changeme + + admin + changeme + +``` + +Then, restart your icecast2 service. + +``` +sudo systemctl restart icecast2 +``` + +> Note: If you change the source password, you may need to manually configure Libretime to use the new password: go to **Settings** > **Streams**, set the streaming server to **Custom** and fill out the **Additional Options** below Stream 1. + +### Rabbitmq + +To change the default password for Rabbitmq, run the following command + +``` +sudo rabbitmqctl change_password airtime newpassword +``` + +and then update the `/etc/airtime/airtime.conf` file with the new password. \ No newline at end of file diff --git a/docs/_docs/host-configuration.md b/docs/_docs/host-configuration.md index 23946709f..20fc90c88 100644 --- a/docs/_docs/host-configuration.md +++ b/docs/_docs/host-configuration.md @@ -55,48 +55,6 @@ used by the various components of LibreTime, run the following commands sudo systemctl restart libretime-celery sudo systemctl restart libretime-analyzer -### Changing the default PostgreSQL passwords {#postgre} - -Two of the most important passwords that should be changed *immediately* after installation -are the passwords used by the PostgreSQL database. -It is strongly recommended that you do this before exposing your server to the internet beyond your internal network. - -1. Login to PostgreSQL with `sudo -u postgres psql`. The PostgreSQL shell - `postgres=#` - means that you have logged in successfully. -2. Change the admin password with `ALTER USER postgres PASSWORD 'myPassword';`, where `myPassword` is the new password. -Make sure to include the semicolon at the end! A response of `ALTER ROLE` means that the command ran successfully. -3. Change the password for the *airtime* user with `ALTER USER airtime WITH PASSWORD 'new_password';` -A response of `ALTER ROLE` means that the command ran successfully. -4. If all is successful, logout of PostgreSQL with `\q`, go back to */etc/airtime/airtime.conf* to edit the password -in the config file, and restart all services mentioned in the previous section. - -### Changing the default Icecast passwords {#icecast} - -Random passwords are generated for Icecast during the installation. To look up and change the passwords, look in the file below. - -`/etc/icecast2/icecast.xml` - -Replace the admin and `changeme` field below with your own username and password. - -``` - - - changeme - - changeme - - admin - changeme - -``` - -Then, restart your icecast2 service. - -``` -service icecast2 restart -``` - -> Note: If you change the source password, you may need to manually configure Libretime to use the new password: go to **Settings** > **Streams**, set the streaming server to **Custom** and fill out the **Additional Options** below Stream 1. - ### API client configuration {#api} The LibreTime API enables many types of information about the broadcast schedule and configuration to be retrieved from the LibreTime server. Other than the live-info and week-info data fetched by website widgets (see the chapter *Exporting the schedule*), all API requests must be authenticated using the secret API key stored in the file */etc/airtime/api\_client.cfg* on the LibreTime server. This key is autogenerated during LibreTime installation and should be unique for each server.