How to upgrade Chevereto v3 to v4

[mar]

backup:
make a backup of your Chevereto in case you screw things up
the database & directory
backup-uploader-files.zip

restore:
if you mess it up and need to restore do this
cd /home/mar/z-MyFiles
unzip backup-uploader-files.zip
cd /home/mar/z-MyFiles/uploader
mv * /home/mar/mar101xy.com/uploader
mv .[!.]* /home/mar/mar101xy.com/uploader
mv .??* /home/mar/mar101xy.com/uploader
restore done


upgrade:
cd /home/mar/mar101xy.com/uploader/app
rm -rf vendor
cd /home/mar/z-MyFiles
unzip chevereto_4.1.4_3f00c0cafadf.zip -d new
cd new

#copy update files to uploader folder
cp -r . /home/mar/mar101xy.com/uploader/

#done
switch to php 8

#rename settings.php to env.php
mv settings.php env.php

edit the env.php with your database information and some new information.
this part is tricky. Copy the few lines that are in your file to a temporary file because it contains some information like your database you will need .

So you need to delete everything that is inside that file and copy everything i have written below:

<?php

/*
 * This file is part of Chevereto.
 *
 * (c) Rodolfo Berrios <rodolfo@chevereto.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

return [
  'CHEVERETO_ASSET_STORAGE_ACCOUNT_ID' => '',
  'CHEVERETO_ASSET_STORAGE_ACCOUNT_NAME' => '',
  'CHEVERETO_ASSET_STORAGE_BUCKET' => '',
  'CHEVERETO_ASSET_STORAGE_KEY' => '',
  'CHEVERETO_ASSET_STORAGE_NAME' => 'assets',
  'CHEVERETO_ASSET_STORAGE_REGION' => '',
  'CHEVERETO_ASSET_STORAGE_SECRET' => '',
  'CHEVERETO_ASSET_STORAGE_SERVER' => '',
  'CHEVERETO_ASSET_STORAGE_SERVICE' => '',
  'CHEVERETO_ASSET_STORAGE_TYPE' => 'local',
  'CHEVERETO_ASSET_STORAGE_URL' => '',
  'CHEVERETO_CONTEXT' => '',
  'CHEVERETO_DB_DRIVER' => 'mysql',
  'CHEVERETO_DB_HOST' => 'localhost',
  'CHEVERETO_DB_NAME' => 'mysite_db',
  'CHEVERETO_DB_PASS' => 'mypassword',
  'CHEVERETO_DB_PDO_ATTRS' => '[]',
  'CHEVERETO_DB_PORT' => '3306',
  'CHEVERETO_DB_TABLE_PREFIX' => '',
  'CHEVERETO_DB_USER' => 'my_db_user',
  'CHEVERETO_DEBUG_LEVEL' => '1',
  'CHEVERETO_ENABLE_API_GUEST' => '1',
  'CHEVERETO_ENABLE_BANNERS' => '1',
  'CHEVERETO_ENABLE_BULK_IMPORTER' => '1',
  'CHEVERETO_ENABLE_CAPTCHA' => '1',
  'CHEVERETO_ENABLE_CDN' => '1',
  'CHEVERETO_ENABLE_CHECK_UPDATES' => '1',
  'CHEVERETO_ENABLE_CONSENT_SCREEN' => '1',
  'CHEVERETO_ENABLE_COOKIE_COMPLIANCE' => '1',
  'CHEVERETO_ENABLE_EXPOSE_PAID_FEATURES' => '1',
  'CHEVERETO_ENABLE_EXTERNAL_SERVICES' => '1',
  'CHEVERETO_ENABLE_EXTERNAL_STORAGE' => '1',
  'CHEVERETO_ENABLE_FAVICON' => '1',
  'CHEVERETO_ENABLE_FOLLOWERS' => '1',
  'CHEVERETO_ENABLE_HTACCESS_CHECK' => '0',
  'CHEVERETO_ENABLE_IP_BANS' => '1',
  'CHEVERETO_ENABLE_LANGUAGE_CHOOSER' => '1',
  'CHEVERETO_ENABLE_LIKES' => '1',
  'CHEVERETO_ENABLE_LOCAL_STORAGE' => '1',
  'CHEVERETO_ENABLE_LOGIN_PROVIDERS' => '1',
  'CHEVERETO_ENABLE_LOGO' => '1',
  'CHEVERETO_ENABLE_MODERATION' => '1',
  'CHEVERETO_ENABLE_NOTIFICATIONS' => '1',
  'CHEVERETO_ENABLE_PAGES' => '1',
  'CHEVERETO_ENABLE_PHP_PAGES' => '0',
  'CHEVERETO_ENABLE_POWERED_BY_FOOTER_SITE_WIDE' => '0',
  'CHEVERETO_ENABLE_ROUTING' => '1',
  'CHEVERETO_ENABLE_SERVICE_AKISMET' => '1',
  'CHEVERETO_ENABLE_SERVICE_MODERATECONTENT' => '1',
  'CHEVERETO_ENABLE_SERVICE_PROJECTARACHNID' => '1',
  'CHEVERETO_ENABLE_SERVICE_STOPFORUMSPAM' => '1',
  'CHEVERETO_ENABLE_STOPWORDS' => '1',
  'CHEVERETO_ENABLE_UPDATE_CLI' => '1',
  'CHEVERETO_ENABLE_UPDATE_HTTP' => '1',
  'CHEVERETO_ENABLE_UPLOAD_FLOOD_PROTECTION' => '1',
  'CHEVERETO_ENABLE_UPLOAD_PLUGIN' => '1',
  'CHEVERETO_ENABLE_UPLOAD_WATERMARK' => '1',
  'CHEVERETO_ENABLE_USERS' => '1',
  'CHEVERETO_ENABLE_SEO_IMAGE_URL' => '1',
  'CHEVERETO_ENABLE_SEO_ALBUM_URL' => '1',
  'CHEVERETO_ENCRYPTION_KEY' => '',
  'CHEVERETO_ERROR_LOG' => 'php://stderr',
  'CHEVERETO_HEADER_CLIENT_IP' => '',
  'CHEVERETO_HOSTNAME_PATH' => '/uploader/',
  'CHEVERETO_HOSTNAME' => 'mar101xy.com',
  'CHEVERETO_HTTPS' => '1',
  'CHEVERETO_IMAGE_FORMATS_AVAILABLE' => '["JPEG","PNG","BMP","GIF","WEBP"]',
  'CHEVERETO_IMAGE_LIBRARY' => 'imagick',
  'CHEVERETO_MAX_ALBUMS' => '0',
  'CHEVERETO_MAX_EXECUTION_TIME_SECONDS' => '30',
  'CHEVERETO_MAX_IMAGES' => '0',
  'CHEVERETO_MAX_MEMORY_SIZE' => '512M',
  'CHEVERETO_MAX_POST_SIZE' => '64M',
  'CHEVERETO_MAX_UPLOAD_SIZE' => '64M',
  'CHEVERETO_MAX_USER_ALBUMS_LIST' => '300',
  'CHEVERETO_MAX_USERS' => '0',
  'CHEVERETO_SERVICING' => 'server',
  'CHEVERETO_SESSION_SAVE_HANDLER' => 'files',
  'CHEVERETO_SESSION_SAVE_PATH' => '/tmp',
  'CHEVERETO_EDITION' => 'pro',
  'CHEVERETO_BINARY_FFMPEG' => 'ffmpeg',
  'CHEVERETO_BINARY_FFPROBE' => 'ffprobe',
];

Now. These are the lines you will most need to fill in with your website details

'CHEVERETO_DB_DRIVER' => 'mysql',
'CHEVERETO_DB_HOST' => 'localhost',
'CHEVERETO_DB_NAME' => 'mysite_db',
'CHEVERETO_DB_PASS' => 'mypassword',
'CHEVERETO_DB_TABLE_PREFIX' => '_chev',
'CHEVERETO_DEBUG_LEVEL' => '1',
'CHEVERETO_HOSTNAME_PATH' => '/uploader/',
'CHEVERETO_HOSTNAME' => 'mar101xy.com',

I will explain these lines.
first one is your type of database. Most likely you are running mysql like me
this one is localhost most times for everyone else
your database name
your database password
your database prefix. you can check your phpmyadmin for your prefix
if you want to see your site errors change that to 2 so you can see the errors but change it back to 1
my image hosting site is using a subdomin a

https://mar101xy.com/uploader

you need the / at the begning and the / at the end or you will get errors
your site domain

save the file and then go to your website and it should be working. You will need to log in and go to the following url:

https://mar101xy.com/uploader/upgrade

it will upgrade then database and you will be finished



don't forget to add the cron
on my old v3 it was

v3 cron
/usr/local/bin/ea-php74 /home/mar/mar101xy.com/uploader/cli.php -C cron >/dev/null 2>&1


v4 is
/usr/local/bin/ea-php81 /home/mar/mar101xy.com/uploader/app/bin/legacy -C cron >/dev/null 2>&1

change your php version and path


if you have problems the best thing you can do is try installing a fresh copy to see if you can install it without issues. Dont try to figure out why you can't upgrade unless you are certain you can install a fresh copy