This is the upgrade documentation for Dymension mainnet, version v4.0.0.

The upgrade is scheduled for block 10192266 which is ~ Nov 24, 2025, 13:00:00 UTC

Here is the information of the upgrade:

• Version: v4.0.0
• Release page: https://github.com/dymensionxyz/dymension/releases/tag/v4.0.0

Here are the steps for validators to apply upgrade:

• Run until reaching upgrade height. Upon upgrade height reached, the node should panic.

• Stop the node. If the node is running as a system service, run systemctl stop <dymension-service>.service

• Update the service file with permissions to create data directory within the .dymension directory (required by upgrade)

  1. You can confirm the exact location by running:

  systemctl status <dymension-service>.service
  
  

  Look for the line that says “Loaded:” — it shows the full path to the service file.

  1. Open the service file.

     Use a text editor such as nano to open it:

  sudo nano /etc/systemd/system/<dymension-service>.service
  
  

  1. Update the service configuration.

     In the [Service] section, add the following line (if it doesn’t already exist):

  WorkingDirectory=/home/<user>/.dymension
  
  

  1. Replace <user> with your actual Linux username.

     Example for mzonder username:

  	WorkingDirectory=/home/mzonder/.dymension
  
  

  1. Save and close the file.

• IMPORTANT: make sure you use go version 1.24.6

go version
# go version go1.24.6

• Build the new binary from source:

cd $HOME
git clone [<https://github.com/dymensionxyz/dymension.git>](<https://github.com/dymensionxyz/dymension.git>)
cd dymension
git checkout v4.0.0
make install

• Check the version

dymd version
# v4.0.0