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

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

For a self-hosted Coolify installation, a normal update replaces the Coolify control plane and briefly restarts that control plane. It does not update, redeploy, or migrate the applications, databases, services, or servers that Coolify manages. The safest sequence is to create and export an instance backup, preserve /data/coolify/source/.env (especially its APP_KEY), review the release notes, let active deployments finish, perform the update during a maintenance window, and verify every connection afterward.

Coolify Cloud is updated by the Coolify team. The dashboard and terminal procedures below apply to self-hosted instances. A PostgreSQL major-version migration is a separate database operation with different backups, downtime, and rollback requirements; it is not part of an ordinary Coolify update.

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

What a Coolify update actually changes

The self-hosted control plane

The documented update changes the version of the self-hosted Coolify control plane. That is the dashboard, API, job orchestration, and configuration layer you use to deploy and administer resources. During the update, this control plane restarts, so the dashboard is temporarily unavailable.

The update does not update the software running in your managed resources. Your application images, application containers, databases, other services, and operating systems on managed servers remain at their existing versions unless you separately ask Coolify to change them.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.

What happens to running applications

Because the operation targets the control plane rather than each resource, it is not an application upgrade or redeploy. Existing workloads are not selected for an update by this procedure. Deployment actions already in progress should be allowed to finish before the maintenance window, however: the dashboard and its job runner will be unavailable while the control plane restarts, so starting a deployment at that moment can leave you without normal status or control.

What does not happen to PostgreSQL

A normal Coolify update does not migrate the internal PostgreSQL database to a newer PostgreSQL major version. Treat an intentional major-version change as its own maintenance project, with a database dump, volume safeguards, and a tested rollback path.

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

Pre-update safety checklist

Complete these checks before opening the update screen or running an updater from SSH.

  • Confirm the operating model. These instructions are for self-hosted Coolify. Coolify Cloud updates are managed by the Coolify team.
  • Record the current state. Note the current Coolify version, the servers connected to the instance, and any deployments or maintenance already underway. This gives you a comparison point after the restart.
  • Read the release notes for the version you intend to install. Look for required intermediate versions, configuration changes, known migration work, and any release-specific instructions. Do not assume that the newest available entry is suitable for every older installation.
  • Drain active deployments. Wait until running deployments and other long-running control-plane jobs report completion. If a deployment cannot be completed safely, postpone the Coolify update rather than starting it while work is active.
  • Create an instance backup. Use Coolify’s instance-backup facility before changing the control plane. A backup is the recovery point for the Coolify instance, not merely a copy of one application.
  • Move important backup material off the server. An on-server backup cannot protect you from loss of that server, its storage, or its credentials. Copy the backup to storage you can access independently and verify that the copy can be read.
  • Preserve the environment file. Keep a protected copy of /data/coolify/source/.env. It contains the instance APP_KEY, which is needed when recovering the Coolify installation. Treat this file as sensitive secret material; do not publish it in a ticket or repository.
  • Choose a maintenance window. The dashboard will be unavailable while the control plane restarts. Schedule the work when operators do not need to start deployments, inspect jobs, or change resources.
  • Prepare access. If you will use the terminal, confirm SSH access and leave yourself a second way to reach the server. Avoid closing the session while the updater is still running.

Update from the self-hosted dashboard

The dashboard route is the simplest method when your instance is healthy and the available release is compatible with your installation.

  1. Open the update page. Sign in to the self-hosted Coolify dashboard and go to Settings → Updates.
  2. Check the offered version. Compare it with the release notes you reviewed. If the notes require an intermediate release or a manual action, complete that requirement instead of clicking through blindly.
  3. Confirm the recovery point. Make sure the instance backup finished and that the important backup material, including the protected .env copy, exists outside the Coolify server.
  4. Start the update. Use the available update action on the Updates page. This starts a control-plane update; it does not ask your applications or databases to upgrade.
  5. Wait through the restart. The dashboard may stop responding while the new control plane is installed and restarted. Do not repeatedly start another update because the login page is temporarily unavailable.
  6. Verify before resuming normal work. Once the dashboard returns, complete the post-update checks below before launching a new deployment.

If the dashboard cannot reach the update service, the instance is in a failed state, or the release notes call for terminal administration, use the current official terminal procedure for the selected release rather than improvising an image pull. Pulling an application image is not a substitute for updating the Coolify control plane.

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth

Update from the terminal

Terminal administration is useful when the dashboard is unavailable, when you need an auditable SSH session, or when the release instructions explicitly require it. The exact updater procedure can vary by Coolify release, so follow the current official procedure for the version you selected rather than copying a command intended for a different release.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Connect over SSH and check your recovery materials. Confirm the external backup and the saved /data/coolify/source/.env are available before changing anything.
  2. Review the release-specific instructions again. Make sure the command or script you are about to run is for a self-hosted control-plane update, not for an application, service, or database.
  3. Run the documented updater. Start it from the SSH terminal in accordance with the selected release’s instructions.
  4. Keep the terminal open. Wait until the updater explicitly reports completion. Disconnecting early can hide an error and make recovery harder.
  5. Save the upgrade log. Coolify writes a timestamped log under /data/coolify/source/, for example upgrade-2026-07-11-12-00-00.log. Preserve the newest log with the backup and record the date, installed version, and any warnings.
  6. Run the verification checklist. Do not treat a returned SSH prompt as proof that the dashboard, resources, and server connections are healthy.

Post-update verification

Use the first minutes after the restart to test the control plane systematically.

  1. Open the dashboard. Confirm that it loads without an error page, authentication loop, or missing static assets.
  2. Confirm the version. Check that the dashboard displays the version you intended to install, not the previous version or an incomplete state.
  3. Inspect projects. Open the projects list and at least one project you actively operate. Verify that environments, deployments, and resource entries are present.
  4. Inspect resources. Check that the applications, databases, and services you expect are still listed with their existing configuration. The normal update should not have changed their software versions.
  5. Validate the local server. Go to Servers → localhost and run the validation. A successful result confirms that the updated control plane can still administer its local Docker host.
  6. Validate other managed servers. Open each remote server and confirm that its connection remains healthy. A control-plane update can complete even when a particular server credential, network route, or agent has a separate problem.
  7. Check recent job history. Look for failed or stuck jobs created around the maintenance window and compare their timestamps with the saved upgrade log.
  8. Perform a controlled smoke test. If your change policy allows it, trigger a small, reversible deployment or inspect an existing health check. Do this only after the dashboard and server validations succeed.

Keep the timestamped upgrade log even when everything works. It records which updater run produced the current state and is valuable if a later deployment exposes a compatibility problem.

How to recover if the updated control plane is unusable

Use the known-good instance backup

If the dashboard remains unusable, the updater reports an unrecoverable error, or critical configuration is missing, stop making repeated changes and use the known-good instance backup. Keep the newest upgrade log with the incident record. Recovery requires the backup data and the preserved /data/coolify/source/.env, including its APP_KEY.

Do not rely on a dump that exists only on the affected server. If the server’s disk, Docker volumes, or filesystem is damaged, that copy may be unavailable at the moment you need it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

Understand the limit of a downgrade

Downgrading Coolify replaces the version of the self-hosted control plane. It does not restore the earlier database state. A downgrade therefore is not a substitute for restoring a compatible backup: the older control-plane code may still be pointed at data that was changed by the newer version. Restore the known-good instance state when the database state also has to be rolled back.

Do not retry blindly

Before a second update attempt, identify whether the failure is a transient service issue, a release prerequisite, a storage problem, or a database compatibility problem. The timestamped log and the release notes should guide the next action. Repeated retries can overwrite useful evidence or create a state that is harder to restore.

PostgreSQL major-version migrations are a separate operation

Coolify’s internal PostgreSQL database has its own lifecycle. The ordinary Coolify update leaves the PostgreSQL major version alone. If you deliberately need a newer supported major version, plan and execute the migration separately from the control-plane update.

Before starting a migration

  • Confirm that the coolify-db container is running.
  • Print its current server_version and record the result.
  • Choose a target that is a higher supported numeric major version. Do not use an arbitrary number simply because it is newer.
  • Copy the database backup outside the Coolify server and retain the protected /data/coolify/source/.env with its APP_KEY.
  • Schedule downtime for the Coolify dashboard and make sure nobody is starting deployments or changing resources.

The version check can be performed in PostgreSQL with SELECT server_version;. Record both the current and target majors in the maintenance notes so that a rollback decision is unambiguous.

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

Run the supplied migration procedure

For a supported deliberate migration, run:

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

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

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.

Those actions are different from a normal control-plane update: they change the database engine major version and create new storage. Never delete the previous volume or rollback metadata merely because the new container starts.

Verify the migration

  1. Confirm that the database reports the intended target major version.
  2. Open the Coolify dashboard and check that authentication and normal navigation work.
  3. Confirm that projects and resources are present.
  4. Validate Servers → localhost and then each managed server.
  5. Review the migration output and retain the compressed dump, rollback metadata, and logs.

Roll back a PostgreSQL migration

While the previous volume and rollback metadata remain available, the documented rollback command is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
/data/coolify/source/upgrade-postgres.sh rollback

Keep the terminal open through the rollback and repeat the database-version, dashboard, project, resource, and server-connection checks afterward. If the previous volume or metadata has been removed, this rollback path is no longer available; that is why external backup copies and retention rules matter.

Choosing a dashboard or terminal update path

Consideration Dashboard update Terminal update
Access method Self-hosted dashboard at Settings → Updates SSH session using the current release-specific official procedure
Best fit Healthy instance with a visible compatible update Dashboard unavailable, release instructions require manual work, or an auditable shell session is preferred
Maintenance control Start from the UI, then wait through the control-plane restart Directly observe updater output and retain the terminal log context
Release compatibility Follow the release notes for the offered version Follow the release notes and use the exact procedure for the selected release
Backup requirement Instance backup, external copy, and preserved .env are required before starting The same recovery materials are required; SSH access does not replace a backup
Verification Dashboard, version, projects, resources, localhost, and managed servers The same checks, plus the timestamped upgrade log under /data/coolify/source/
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Normal Coolify update versus PostgreSQL major migration

Property Normal Coolify update PostgreSQL major migration
Primary change Self-hosted Coolify control-plane version Internal PostgreSQL engine major version and its storage container/volume
Applications and managed services Not updated by the procedure Not application upgrades, but the Coolify control plane is stopped while the database changes
External backup Instance backup and an off-server copy of important backup material Those safeguards plus the compressed internal pg_dumpall backup and preserved previous volume
Dashboard availability Temporarily unavailable during the control-plane restart Unavailable while the application container is stopped and the new database is created and validated
Rollback artifact Known-good instance backup; a downgrade alone does not restore prior database state Previous PostgreSQL volume, rollback metadata, and the command upgrade-postgres.sh rollback
Verification depth Dashboard, version, projects, resources, and server connections Database target version plus all normal dashboard, project, resource, and server checks

Coolify CLI updates are independent

The Coolify CLI is a separate client from the self-hosted Coolify control plane. Updating one does not update the other.

To update the CLI binary to the latest release for your operating system and architecture, run:

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.
coolify update

Then verify the installed client and its contexts:

coolify version
coolify context verify

The CLI update leaves its configuration file and saved contexts unchanged. You still need to update the self-hosted dashboard separately if your goal is to change the Coolify control-plane version.

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

Common failure modes and practical responses

The dashboard is unavailable longer than expected

Wait for the updater to finish before assuming failure. If you used SSH, inspect the live output and the newest upgrade-*.log file. Do not launch a second update from another session. If the log shows an unrecoverable error, use the instance backup and preserved environment file rather than repeatedly restarting containers.

A deployment was running when maintenance began

Allow the job to reach a clear completed or failed state if possible. Once the dashboard returns, inspect job history and the application itself before retrying. The control-plane update did not intentionally upgrade the application, so any application-side issue needs to be diagnosed as a deployment or workload problem rather than assumed to be a Coolify version change.

Localhost or a remote server fails validation

First confirm that the dashboard version and projects are intact. Then inspect the affected server’s connection details, network reachability, credentials, and Docker availability independently of the control-plane update. A failed server validation does not by itself prove that the Coolify update rolled back or corrupted the project data.

The recovery process asks for a missing application key

Locate the protected copy of /data/coolify/source/.env. Its APP_KEY is part of the instance’s recovery material. If that file was never copied and the server is lost, recovery may not be able to reconstruct the original encrypted state.

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

A PostgreSQL migration must be reversed

Do not use an ordinary Coolify downgrade as a database rollback. Keep the previous PostgreSQL volume and rollback metadata, run /data/coolify/source/upgrade-postgres.sh rollback while those artifacts remain available, and then repeat the full verification sequence.

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.