October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Update Coolify to the Latest Version Safely

A practical self-hosted Coolify update guide covering backups, the dashboard and terminal paths, verification, rollback, PostgreSQL migrations, and the separate CLI update.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a self-hosted Coolify instance, the safe update is a control-plane upgrade: back up the instance, preserve /data/coolify/source/.env (including its APP_KEY), finish active deployments, then update from Settings → Updates or the current official terminal procedure. The dashboard is unavailable briefly while the control plane restarts. Your managed applications, databases, services, and servers are not upgraded by this operation.

Coolify Cloud is updated by the Coolify team, so the self-hosted procedure below does not apply to Cloud accounts. A PostgreSQL major-version migration is also a separate, higher-risk operation with its own dump, volume, and rollback safeguards.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What a normal Coolify update actually changes

Coolify’s documented self-hosted update replaces the version of the Coolify control plane. It does not update the workloads that the control plane manages. In practical terms, the update changes Coolify’s dashboard, orchestration logic, and internal control-plane components, while leaving your deployed applications, databases, services, and managed servers outside the update scope.

“Updating Coolify changes the self-hosted Coolify control plane. It does not update the applications, databases, services, or servers you manage with Coolify.”

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

— Coolify documentation, “Update Coolify”

The control plane must restart to load the new version, so the dashboard is temporarily unavailable during the maintenance window. Plan around that interruption and do not begin while a deployment is still running.

What is not included

  • Application images are not upgraded.
  • Managed PostgreSQL, MySQL, Redis, or other databases are not upgraded.
  • Services deployed through Coolify are not upgraded.
  • Remote or local managed servers are not upgraded.

This boundary is important when interpreting a successful update: a new Coolify version does not mean that every application image or database engine is now on a newer release.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Self-hosted or Cloud: identify the operating model first

Self-hosted instances

The terminal and dashboard procedures in this guide apply to Coolify installations that you administer on your own server. You need administrative access to the Coolify dashboard and, when using the terminal procedure, an SSH session with the permissions required by the current release’s upgrade instructions.

Coolify Cloud

Coolify Cloud updates are managed by the Coolify team. Do not run the self-hosted commands against a Cloud account. Use the Cloud service’s normal account and status channels for availability and version information.

Prepare recovery before opening the updater

A backup is the first safety control, not an optional post-update task. Create an instance backup before you start, and make sure the copy you would need for recovery is not trapped on the same server as the installation.

Create and export an instance backup

  1. Open the self-hosted Coolify dashboard and create an instance backup using the available backup function.
  2. Wait for the backup operation to finish and confirm that the resulting artifact exists.
  3. Copy important backup material to storage outside the Coolify server. An on-server dump alone does not protect you from a failed disk, filesystem corruption, or an inaccessible host.
  4. Preserve /data/coolify/source/.env in a secure location. This file contains the instance APP_KEY, which is needed to recover the installation correctly.

Protect the exported file and backup according to your organization’s secret-handling policy. The .env file can contain sensitive configuration; do not paste it into tickets or commit it to a public repository.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When PostgreSQL migration is also planned

If your maintenance window includes a deliberate PostgreSQL major-version migration, treat the recovery preparation as a separate project. Keep an external copy of the PostgreSQL dump, the previous database volume information, rollback metadata, and /data/coolify/source/.env. Do not assume that an ordinary instance backup or a normal Coolify update will create a database-major-version rollback point.

Read the release notes and drain work

Review the release notes for the exact Coolify version you intend to install. Look for migration notes, prerequisites, known issues, and any version-specific change to the supported update procedure. The updater itself should be the current procedure for that release; do not replace it with an arbitrary container-image pull.

Finish active deployments

Allow every active deployment to complete before starting the update. Starting a control-plane restart while a deployment is in progress can leave you without dashboard visibility when you most need it. If a deployment is stuck, resolve or deliberately cancel it first, then confirm the project is idle.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Choose the maintenance window

Schedule a period in which a short dashboard interruption is acceptable. The restart affects Coolify’s management interface; it is not an instruction to redeploy every application. Keep an SSH connection available even if you plan to begin from the dashboard, because the terminal is useful for watching progress and preserving logs.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose a self-hosted update path

Use the dashboard path when the current interface is healthy and the available update is presented there. Use the terminal procedure when the release notes require it, when dashboard access is impaired, or when your operations process requires a visible SSH transcript.

Decision factor Dashboard update Terminal update
Access method Self-hosted dashboard, Settings → Updates SSH session with the current official upgrade procedure
Maintenance-window control Simple to start, but progress is viewed through the interface that will restart Terminal remains available while the dashboard restarts
Release-note compatibility Use when the offered update matches the supported path for your release Required when release instructions specify terminal administration
Backup readiness Instance backup and exported recovery material still required Same backup requirement; keep the shell open until completion
Post-update verification Return to the dashboard and test resources and servers Use the completion message and timestamped log, then perform the same dashboard checks

Step-by-step: update a self-hosted Coolify control plane

1. Confirm the target version

Record the version currently installed and the version you plan to install. Read the target release notes and confirm that your installation meets any stated prerequisites. This record makes later troubleshooting and rollback decisions much clearer.

2. Confirm recovery material

Verify that the instance backup completed, that an important copy is outside the server, and that /data/coolify/source/.env was preserved with its APP_KEY. If any of these checks fails, stop and fix the recovery plan before updating.

3. Drain deployments

In the dashboard, check the deployment activity for every project and resource. Wait for running jobs to finish and make sure no scheduled operation is about to start during the maintenance window.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

4. Start the supported updater

  1. For a dashboard update, open Settings → Updates in the self-hosted Coolify dashboard and use the available update action.
  2. For a terminal update, follow the current official Coolify upgrade procedure for the selected release. Do not substitute a generic Docker image pull or an application redeploy for the control-plane updater.

The exact terminal invocation can change with the release, so use the procedure documented for the version you selected rather than copying an old command from an unrelated installation.

5. Keep the terminal open until completion

If you started or are monitoring the operation through SSH, keep that shell open until the updater reports completion. Interrupting the session can hide the final status and leave you without the most useful diagnostic information.

The update writes a timestamped log under /data/coolify/source/. A log name may look like upgrade-2026-07-11-12-00-00.log; the date and time in that example identify the run and are not a promise of a particular filename for your update.

6. Wait for the control-plane restart

Expect the dashboard to be unavailable while Coolify restarts. Do not repeatedly start another update because the login page is temporarily unreachable. Wait for the updater’s completion message and for the service to become responsive again.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

7. Record the result

Retain the newest upgrade log with your maintenance record. Note the old version, target version, start and finish times, backup location, and any warnings printed by the updater.

Post-update verification: prove that management recovered

When the dashboard returns, verify the control plane in layers rather than relying only on a successful login.

Check Expected result If it fails
Dashboard access The dashboard opens without an error or endless loading state Use the retained upgrade log and the server’s service status to identify the failed startup step
Version display The expected Coolify version is shown Do not start a second upgrade until you establish whether the first run completed
Projects and resources Existing projects, applications, databases, and services are present Check that you are viewing the same instance and inspect the upgrade log before attempting recovery
Servers → localhost The localhost connection validates successfully Investigate the local server connection and Docker access; preserve the log before changing configuration
Other managed servers Each previously connected managed server still connects Test the affected connection individually; an application redeploy is not a fix for a control-plane connection problem

These checks verify the control plane and its inventory. They do not constitute an application upgrade. If an application needs a newer image or a database needs a security patch, schedule that work separately using the application or database’s own procedure.

What to do if the update is unusable

Preserve evidence first

Keep the newest timestamped upgrade log and note what changed immediately before the failure. Avoid deleting containers, volumes, or source files while you are still deciding whether the problem is a startup issue, a connection issue, or an incompatible database state.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Restore a known-good instance backup

If the updated control plane cannot be made usable, use the known-good instance backup and the preserved /data/coolify/source/.env. Recovery should restore a compatible control-plane and database state, not merely replace one application image.

Why a downgrade is not a complete rollback

Coolify’s downgrade operation replaces the self-hosted control-plane version. It does not automatically restore the earlier database state. Therefore, repeatedly downgrading is not a substitute for restoring a compatible backup when the update has changed data structures or migration state.

“Downgrading Coolify replaces the version of the self-hosted Coolify control plane.”

— Coolify documentation, “Downgrade Coolify”

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

PostgreSQL major-version upgrades are a separate operation

A normal Coolify update does not migrate the internal PostgreSQL database to a newer major version.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

“A normal Coolify update does not migrate this database to a newer PostgreSQL major version.”

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

— Coolify documentation, “Update Coolify Database”

Do not infer a PostgreSQL upgrade from a successful Coolify update. If you intentionally need a newer major version, schedule and execute that migration independently.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Preflight checks

  1. Confirm that the internal coolify-db container is running.
  2. Print and record its current server_version.
  3. Choose a higher supported numeric major version as the target. The target must be a supported major and numerically higher than the current one.
  4. Confirm that the external backup, the current database volume information, rollback metadata, and /data/coolify/source/.env are available.
  5. Choose a window that allows the Coolify application container to stop and the database volume to be created and validated.

Record the current version before changing anything. That value is the reference for verifying the migration and for deciding whether a rollback is necessary.

Run the migration script

From the Coolify host, run the supplied migration script with the target major version:

/data/coolify/source/upgrade-postgres.sh <target-major>

Keep the shell open until the script completes. The documented workflow stops the Coolify application container, creates a compressed pg_dumpall backup under /data/coolify/backups/internal-postgres/, creates and validates a new database volume and container, writes rollback metadata, and starts the stack with the new database.

The script’s internal dump is an important safeguard, but it should not be your only copy. Keep the separately exported backup outside the Coolify server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Verify the migrated database and control plane

  • Confirm that the database reports the intended target major version.
  • Open the dashboard and confirm that it loads normally.
  • Check that projects and resources are present.
  • Validate Servers → localhost.
  • Test every other managed-server connection that matters to your operations.

Only after these checks pass should you treat the migration as complete. A successful script exit without a usable dashboard or valid server connections is not sufficient.

Rollback the PostgreSQL migration

Rollback is available while the previous volume and rollback metadata remain available:

/data/coolify/source/upgrade-postgres.sh rollback

Use the rollback command from the Coolify host, keep the shell open, and then repeat the database-version, dashboard, project, resource, localhost, and managed-server checks. If the previous volume or metadata has been removed, this scripted rollback path may no longer be available; that is why the external dump and preserved recovery files must be retained.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

Updating the Coolify CLI is different

The Coolify CLI is a separate client from the self-hosted Coolify control plane. Running the CLI update replaces the CLI binary for the operating system and architecture; it does not update the server-side Coolify installation or any managed workload.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

After updating the CLI, verify the client itself and its saved contexts:

coolify version
coolify context verify

The CLI update leaves its configuration file and saved contexts unchanged. If your goal is to update the dashboard or the self-hosted instance, use the self-hosted update procedure instead of coolify update.

Common failure modes and the right response

The dashboard is unreachable immediately after starting

This is expected during the control-plane restart. Wait for the updater to report completion and for the dashboard to return. If it remains unavailable, use the SSH session and the timestamped log rather than launching another update.

The update appears complete, but the old version is still shown

Confirm that you are connected to the intended Coolify host and that the updater actually reported completion. Check the newest log under /data/coolify/source/. Do not assume that pulling a different application image will change the control-plane version.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Projects or resources appear missing

Stop and verify the instance identity, then inspect the upgrade log and backup before changing volumes or configuration. A missing view can be an access or startup problem; deleting data can turn it into permanent loss.

Servers → localhost fails validation

Preserve the log, then investigate local Docker access and the Coolify service state on the host. Re-deploying an application does not repair a broken control-plane connection.

A PostgreSQL version changed unexpectedly

A normal Coolify update is not supposed to perform a PostgreSQL major migration. Record the observed server_version, preserve the current state, and compare the operation you ran with the documented PostgreSQL migration procedure before attempting any rollback.

A compact maintenance record to keep

For each update, retain the following with the timestamped log:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Self-hosted host name and current Coolify version.
  • Target Coolify version and release-note review date.
  • Backup completion time and external backup location.
  • Confirmation that /data/coolify/source/.env and its APP_KEY were preserved.
  • Upgrade start and finish times.
  • Post-update results for the dashboard, version display, projects, resources, Servers → localhost, and other managed servers.
  • For PostgreSQL migrations, the old and target server_version, dump location, volume information, and rollback metadata status.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.