Write guide to explain how to upgrade versions

[D-Vaillant]

Is your feature request related to a problem?

The major blocker for me for upgrading is trying to figure out what I need to migrate from my previous version in order to maintain everything that I already had in place.

Describe the solution you'd like

A specification of which configuration files can/should be copied over would be nice.

Additional context

No response

[stickz]

Hello @D-Vaillant, you should be able to copy over your share and conf folders to retain settings for all hot fix releases. For minor or major versions, replace config.php each time and manually merge your settings into the new version.

The wiki is public editable. If you'd like to write a guide, I'd be happy to answer any of your questions.

[filex100]

How about an option to create a backup?

For when it is necessary to change servers or to have a backup in case the server goes down.

[castillo92]

@D-Vaillant @filex100

This is my 5 steps procedure to update ruTorrent, always manually, but it is easy to move to an automatic batch:

# Update ruTorrent
# Move old version to a backup folder
sudo mv /var/www/rutorrent /home/USER/Desktop/BackUps/rutorrent_2024_11_25

# Download the new version in \var\www
sudo git clone https://github.com/Novik/ruTorrent.git /var/www/rutorrent/

# Restore config file from backup
sudo cp /home/USER/Desktop/BackUps/rutorrent_2024_11_25/conf/config.php /var/www/rutorrent/conf

# Restore login credentials from backup folder
sudo cp /home/USER/Desktop/BackUps/rutorrent_2024_11_25/.htaccess /var/www/rutorrent/
sudo cp /home/USER/Desktop/BackUps/rutorrent_2024_11_25/.htpasswd /var/www/rutorrent/

# Apply web-server permissions to updated folder
sudo chown -R www-data:www-data /var/www/rutorrent

To create login page and protect it:
# Creating file with user and password encrypted, ask for password
sudo htpasswd -c /var/www/rutorrent/.htpasswd USER1
# Create the config file
sudo nano /var/www/rutorrent/.htaccess

AuthUserFile /var/www/rutorrent/.htpasswd
AuthName "Login to access..."
AuthType Basic
require valid-user