Updating via Command Line (SSH)

Overview

If you have SSH access to your server, you can check for updates and run them directly from the command line. This is useful for automated deployments, staging environments, or when you prefer working in the terminal.

Available commands

Check current version

php artisan larapen:version

Displays your current installed version and the code version, and indicates whether an update is available.

Example output:

Larapen Version Information
===========================
Code version:      1.2.0
Installed version: 1.0.0
Status:            Update available

Check update status (detailed)

php artisan larapen:update:status

Shows detailed information about pending updates, including changelogs for each version.

For a specific add-on:

php artisan larapen:update:status --component=addon:blog

Component names:

• core: The main Larapen application (default)
• addon:blog: Blog add-on
• addon:shop: Shop add-on
• addon:helpcenter: HelpCenter add-on
• addon:{name}: Any installed add-on
• theme:{name}: Any installed theme

Run updates

php artisan larapen:update

Runs all pending core updates. The command will:

1. Show the pending versions and their changelogs.
2. Ask for confirmation before proceeding.
3. Display a backup warning.
4. Run each update sequentially and report results.

For a specific add-on:

php artisan larapen:update --component=addon:blog

To skip the confirmation prompt (useful for automated scripts):

php artisan larapen:update --force

Recommended CLI update workflow

1. SSH into your server and navigate to your Larapen directory.
2. Check version status:

   php artisan larapen:version

3. Upload new files via SFTP or Git.
4. Check again:

   php artisan larapen:update:status

5. Run the update:

   php artisan larapen:update

6. Clear caches (done automatically, but you can force it):

   php artisan cache:clear
   php artisan config:clear
   php artisan view:clear