===== Migrating =====

Install dependencies.

<code bash>
sudo apt update
sudo apt dist-upgrade
sudo apt install apache2 mariadb-server libapache2-mod-php php-gd php-mysql php-curl php-mbstring php-intl php-gmp php-bcmath php-xml php-imagick php-zip php-apcu redis-server
</code>

Setup the database.

<code bash>
sudo mysql
</code>

<code sql>
CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'password';
CREATE DATABASE IF NOT EXISTS nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
FLUSH PRIVILEGES;
quit;
</code>

On the original machine, put Nextcloud into maintenance mode.

<code bash>
cd /var/www/nextcloud
sudo -u www-data php occ maintenance:mode --on
</code>

> Wait 6-7 minutes for the sync clients to register the server is in maintenance mode before proceeding.

Stop the web server that runs Nextcloud.

<code bash>
sudo systemctl stop apache2.service
</code>

Copy over the Nextcloud directory to the new machine.

<code bash>
rsync -aAX /var/www/nextcloud root@new-machine:/var/www
</code>

Copy the PHP configurations to the new machine.

<code bash>
rsync -aAX /etc/php/8.2/apache2/ root@new-machine:/etc/php/8.2/apache2
rsync -aAX /etc/php/8.2/cli/ root@new-machine:/etc/php/8.2/cli
</code>

> The PHP version on the new machine must match that from the original machine.

On the new machine, ensure ''%%/etc/php/8.2/mods-available/apcu.ini%%'' is configured correctly.

<code ini>
extension=apcu.so
apc.enable_cli=1
</code>

On the new machine, ensure permissions are set correctly on ''%%/var/www/nextcloud%%''.

<code bash>
sudo chown -R www-data:www-data /var/www/nextcloud
</code>

On the original machine, dump the database.

<code bash>
mysql --single-transaction --default-character-set=utf8mb4 -h localhost -u nextcloud -p nextcloud > nextcloud-sqlbkp.bak
</code>

Copy the database backup to the new machine.

<code bash>
rsync -aAX nextcloud-sqlbkp.bak root@new-machine:/root
</code>

On the new machine, import the database backup.

<code bash>
mysql -h localhost -u nextcloud -p -e "DROP DATABASE nextcloud"
mysql -h localhost -u nextcloud -p -e "CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci"
mysql -h localhost -u nextcloud -p nextcloud < /root/nextcloud-sqlbkp.bak
</code>

On the new machine, ensure redis-server service is started.

<code bash>
sudo systemctl enable --now redis-server.service
</code>

On the new machine, run the following command to update the ''%%data-fingerprint%%'':

<code bash>
cd /var/www/nextcloud
sudo -u www-data php occ maintenance:data-fingerprint
</code>

> Ensure DNS records are changed to the new machine and the web server is running before taking Nextcloud out of maintenance mode.

On the new machine, take Nextcloud out of maintenance mode.

<code bash>
cd /var/www/nextcloud
sudo -u www-data php occ maintenance:mode --off
</code>