Error Codes

Last updated December 21, 2023

Below are errors with descriptions and solutions that you may see if an issue occurs in DevKinsta. Give the suggested solutions a try, and if the issue persists, report it to the DevKinsta Community Forum.

Viewing the Application Log File

Checking the application log file (main.log) is sometimes recommended for investigating errors. This log file can be accessed from the Help and Support screen in DevKinsta; click the question mark (?) icon in the left sidebar, then click Reveal log file in File Manager under the Support forum heading. On macOS, you can also go to Help > Reveal log file in the DevKinsta application menu at the top of the screen.

If you’re unable to start DevKinsta and access the log file through the Help and Support screen, you can open and view the log file manually on your computer. The path to the application log file (main.log) varies slightly between operating systems.

Windows

%userprofile%\AppData\Roaming\DevKinsta\logs

Mac

/Users/<yourusername>/Library/Logs/DevKinsta

Linux

~/.config/DevKinsta/logs on Ubuntu

DK0001

Description: Not enough free disk space.

During certain actions (DevKinsta installation, site creation, site import from MyKinsta, etc.), DevKinsta checks the currently available disk space. If there is not enough disk space on your local machine, you will see this error.

Solution

Free up disk space on your computer, and repeat the action that caused the initial error.

DK0002

Description: There is no internet connection.

During certain actions (DevKinsta installation, site import from MyKinsta, etc.), DevKinsta checks for a stable Internet connection. If your local machine is not connected to the Internet, you will see this error.

Solution

Ensure your computer is connected to the Internet, and repeat the action that caused the initial error.

DK0003

Description: Couldn’t install Docker.

DevKinsta couldn’t install Docker Desktop.

Solution

Ensure your computer is aligning to system requirements and try to install Docker Desktop manually. After you finished the Docker Desktop installation, try to restart DevKinsta.

DK0004

Description: Couldn’t start Docker. Please try to start Docker manually.

DevKinsta couldn’t start Docker Desktop.

Solution

Please try to start Docker Desktop manually and after that restart DevKinsta.

DK0005

Description: Couldn’t create docker containers.

DevKinsta couldn’t create Docker containers.

Solution

Restart Docker Desktop manually and after that, restart DevKinsta.

DK0006

Description: Couldn’t download docker images.

DevKinsta couldn’t load the required Docker images.

Solution

Please check your internet connection. If it is stable, please try to restart DevKinsta.

DK0007

Description: Couldn’t download Docker.

DevKinsta couldn’t download Docker Desktop.

Solution

First, check your internet connection. If it is stable, please try to restart DevKinsta.

DK0008

Description: Couldn’t fetch IP.

DevKinsta couldn’t find Docker’s IP address.

Solution

Please try to restart Docker Desktop manually, and after that, restart DevKinsta.

DK0009

Description: Can’t start docker container

DevKinsta couldn’t start Docker containers.

Solution

Please try to stop DevKinsta related Docker containers, and after that, restart DevKinsta.

docker kill devkinsta_fpm && docker kill devkinsta_nginx && docker kill devkinsta_adminer && docker kill devkinsta_db && docker kill devkinsta_mailhog

DK0010

Description: Couldn’t load docker images.

DevKinsta couldn’t load the required Docker images.

Solution

Please check your internet connection. If it is stable, please try to restart DevKinsta.

DK0011

Description: Unknown server error occurred. Please try it again.

You may see this error if DevKinsta is unable to access the Kinsta API.

Solution

First, check your Internet connection to see if there are any issues. If not, try again later in case the issue is on the MyKinsta API side.

DK0012

Description: Your request timed out. Please try it again.

You may see this error if DevKinsta is unable to access the Kinsta API due to a timeout.

Solution

First, check your Internet connection to see if there are any issues. If not, try again later in case the issue is on the MyKinsta API side.

DK0013

Description: Remote server received wrong data. Please try it again.

You may see this error if DevKinsta receives a bad request error from the Kinsta API.

Solution

Please report this error to the DevKinsta Community Forum.

DK0014

Description: You are unauthenticated. Please try to re-login into MyKinsta account.

You may see this error if DevKinsta receives an unauthorized request error from the Kinsta API.

Solution

Go to the DevKinsta Settings screen, try logging in to your MyKinsta account again, and retry the process.

DK0015

Description: You don’t have permission for this action.

You may see this error if DevKinsta encounters a MyKinsta permissions error when accessing the Kinsta API.

Solution

Go to your MyKinsta profile, and ensure you have the necessary site permissions.

DK0016

Description: Couldn’t find remote server. Please try it again.

You may see this error if DevKinsta receives a 404 error from the Kinsta API.

Solution

Please report this error to the DevKinsta Community Forum.

DK0017

Description: You made too many requests. Please try it again a few minutes later.

You may see this error if DevKinsta encounters a “too many requests” error from the Kinsta API. This error occurs when the Kinsta API is called too frequently.

Solution

Wait a few minutes, and try the action again.

DK0018

Description: You didn’t grant permission for site deletion.

You may see this error if DevKinsta is unable to delete a site due to incorrect permissions to perform the deletion action.

Solution

Windows	macOS
Try to delete the site again, and approve the Windows confirmation dialog.	Try to delete the site again, and provide your correct password when prompted by macOS.

DK0019

Description: NGINX configuration failed

You may see this error if DevKinsta is unable to update the Nginx configuration file.

Solution

First, try restarting DevKinsta and recreating the site. If that does not work, check the sites.ini file in your projectFolder/kinsta folder with a text editor, and remove any duplicate entries.

DK0020

Description: Database creation failed

You may see this error if DevKinsta is unable to create the MySQL database. The database name is derived from the site name. This error occurs if the database name is not valid.

Solution

Try to recreate the site with a different name. If that does not work, try restarting DevKinsta.

DK0021

Description: WordPress site setup failed

You may see this error if DevKinsta is unable to install WordPress.

Solution

Try to restart DevKinsta, and recreating the site.

DK0022

Description: Host file update failed

During site creation, DevKinsta couldn’t update the hosts file. You may see this error if DevKinsta is unable to update the computer’s hosts file.

Solution

Windows	macOS
Try recreating the site, and approve the Windows confirmation dialog.	Try recreating the site, and provide your correct password when prompted by macOS.

DK0023

Description: Can’t add certificate to Keychain

You may see this error if DevKinsta is unable the store the security certificate in the macOS Keychain.

Solution

Try to recreate the site, and ensure you provide the correct password to the macOS dialog prompt.

DK0024

Description: Can’t write to Certificate store

You may see this error if DevKinsta is unable to store the security certificate in the Windows certificate manager.

Solution

DevKinsta needs to be run in Administrator mode for the certificate to be created. Try to recreate the site, and ensure you provide the correct password to the Windows confirmation dialog.

DK0025

Description: Can’t download site

You may see this error if DevKinsta is unable to pull a site from Kinsta.

Solution

Restart DevKinsta, log in to your MyKinsta account in DevKinsta settings and try to pull the site again.

DK0026

Description: Site push failed

You may see this error if DevKinsta is unable to push a site from Kinsta.

Solution

Restart DevKinsta, log in to your MyKinsta account in DevKinsta settings and try to push the site again. If the issue continues, check the application log file (main.log). Searching for the error code (DK0026) in the log file can help narrow down the search and may lead to some more detailed information on the root cause.

If the error persists, please report this error to the DevKinsta Community Forum.

DK0027

Description: Missing host file entry

You may see this error if there is a missing hosts file entry. In this case, you won’t be able to open this site via domain name.

Solution

Click on the Fix this button.

DK0028

Description: You didn’t grant permission for edit the host file.

You may see this error if you don’t grant permission for the hosts file modification.

Solution

Retry the process and provide the required permission.

DK0029

Description: Can’t create mysql dump

You may see this error if, during site pull, DevKinsta is unable to create a MySQL dump on the remote server.

Solution

Try it again later. If it still doesn’t help, please report this error to the DevKinsta Community Forum.

DK0030

Description: OPERATION INTERRUPTED

You may see this error if you close DevKinsta during site creation.

Solution

Click on the Retry button. If DevKinsta cannot recreate the site, please try to delete and recreate the site.

DK0031

Description: Port 80 or 443 is used.

You may see this error if port 80 is used.

Solution

Please try to close the process which is using port 80.

find & kill process on macOS

# find & kill processes which are using port 80
sudo lsof -i tcp:80 | grep LISTEN | awk '{print $2}' | xargs kill -9

find & kill process on Windows

# find processes which are using port 80
netstat -ano | findstr :80


# kill process by PID. replace "<PID>" with result from the above command.
taskkill /PID <PID> /F

DK0032

Description

You may see this error on Windows if WSL2 is not installed or enabled.

Solution

Restart DevKinsta to initiate the WSL2 installation automatically. If DevKinsta is unable to install WSL2, you can download it directly from Microsoft as well.

DK0033

Description: Can’t connect to database

This error occurs when DevKinsta is unable to connect to the MySQL database.

Solution

Follow the steps below to resolve this error.

Export your site’s database with Adminer. (optional)
Close DevKinsta.
Run this command in terminal – docker container rm devkinsta_db && docker volume rm devkinsta_db_data.
Start DevKinsta.
Import the database with Adminer. (optional)

DK0034

Description: Please restart your computer to finish installation.

This error occurs when a computer restart is required.

Solution

Restart the computer and launch DevKinsta.

DK0035

Description

This error occurs on Windows if DevKinsta is unable to download WSL2 during the installation process.

Solution

Restart DevKinsta to start the WSL2 download again.

DK0036

Description

This error occurs if the Windows Subsystem for Linux (WSL2) feature is not enabled.

Solution

Enable WSL2 by following Microsoft’s documentation.

DK0037

Description: Container not found

This error can occur because the Docker container doesn’t exist.

Solution

Follow any instructions provided in the error message. If instructions are not provided or do not resolve the error, restart DevKinsta.

DK0038

Description: Set WP config

This error occurs when the wp-config.php file is missing or misconfigured.

Solution

Click on the Retry button shown in DevKinsta.

DK0039

Description: Docker stops common

If Docker stops and DevKinsta can’t communicate with it, this error is shown.

Solution

Restart Docker Desktop manually, and after that, restart DevKinsta.

DK0040

Description: Could not renew the ssh key.

You may see this error when DevKinsta tries to renew the ssh key during site import.

Solution

First, check your Internet connection to see if there are any issues. If not, try again later in case the issue is on the MyKinsta API side.

DK0041

Description: Invalid TwoFA. Only Authy and TOTP TwoFA are supported.

This error ensures that DevKinsta is clear about which TwoFA methods are supported.

Solution

Use a supported TwoFA method.

DK0044

Description: Can’t write to Certificate store

You may see this error when DevKinsta tries to create a local certificate on the system for your site.

Solution

Try to recreate the site, and ensure you provide the correct password to the Linux dialog prompt.

DK0045

Description: Certificate is not verified

You may see this error when DevKinsta tries to create a local certificate but the verification process fails due to an already existing or certificate in the database.

Solution

For advanced users: try to find and manually delete the corresponding certificates from your database located at “home/yourusername/.pki/nssdb/cert9.db”

DK0046

Description: Failed to install certutil package

You may see this error when DevKinsta tries to install missing packages that are necessary to create and manage certificates on your Linux system.

Solution

Open a terminal window and run sudo apt update, then retry the SSL creation in DevKinsta. You can also try to manually install the necessary packages by running sudo apt install libnss3-tools or combining to two commands and run sudo apt update && apt install libnss3-tools. To check whether the install was successful, run certutil in the terminal and check the output.

DK0047

Description: DevKinsta couldn’t overwrite sites.ini. Site creation is failed.

You may see this error when DevKinsta wants to overwrite the sites.ini file in your DevKinsta root Folder.

Solution

Go to your root DevKinsta folder and go to the kinsta folder. Delete the sites.ini file then start DevKinsta.

DK0048

Description: You don’t have the necessary privileges to start the Docker client. Please set the required permissions and try again.

You may see this error if you use Linux and the Docker client does not have the necessary privileges or permissions to start on your system.

Solution

You need to check your user profile to be sure that you have the necessary permissions to run the docker client.

To temporarily give the permissions to your user profile (for the current session only), run sudo chmod 666 /var/run/docker.sock in terminal, then click on the Retry button in DevKinsta to continue the startup process.

If you want to set the permissions permanently (recommended), add your user profile to the docker group by following the steps below.

Make sure that the docker group exists by running sudo groupadd docker in terminal.
Next, run the groups command to check if your user is added to the docker group.
If you need to add your user to the docker group, run sudo usermod -aG docker $USER.
Run sudo chmod 666 /var/run/docker.sock to set the permission.
Log in and log out in order for the changes to take effect.

DK0049

Description: Could not delete site’s content.

You may see this error if the devkinsta_nginx docker container is not running while you are trying to delete a site’s content.

Solution

Make sure that devkinsta_nginx is running and try again.

DK0050

Description: Could not delete site entry from sites.ini.

You may see this error if the devkinsta_nginx docker container is not running while you are trying to delete the site’s entry from the sites.ini file.

Solution

Make sure that devkinsta_nginx is running and try again.

DK0051

Description: Could not delete the database.

You may see this error when the site’s database cannot be deleted due to internal problems.

Solution

You can try to manually delete the database using the CLI by running the following in terminal:

docker exec devkinsta_db bin/sh -c 'mysql -u root -p[YOUR_DB_PASSWORD] -e "drop database [YOUR_SITE];"'

You can check whether the database has been deleted or not by running the following in terminal:

docker exec devkinsta_db bin/sh -c 'mysql -u root -p[YOUR_DB_PASSWORD] -e "show databases;"'

DK0052

Description: Could not save php.ini content

You may see this error if the devkinsta_fpm container is not running when trying to save your changes in the php.ini editor.

Solution

Make sure that the devkinsta_fpm container is up and running and try again.

DK0053

Description: Could not save php.ini content

You may see this error if the devkinsta_fpm container failed to restart after updating the php.ini file.

Solution

In case clicking on the Retry button does not help, you can either try to start the container manually or restart DevKinsta.

DK0054

Description: Could not update sites.ini with the new ports.

You may see this error if the devkinsta_nginx container is not running while you are trying to update the sites.ini file with the new ports you selected.

Solution

Make sure that the devkinsta_nginx container is running and try again.

DK0055

Description: Could not recreate Nginx container with new ports.

You may see this error when DevKinsta is not able to recreate the devkinsta_nginx container on the new ports you selected.

Solution

If clicking on the retry button does not help, you can either try to relaunch DevKinsta or recreate the devkinsta_nginx container yourself using the docker CLI.

For example, to create the container on ports 80 and 443 on macOS, and Linux, you can run the following in terminal, replacing or setting the ${LATEST_IMAGE_VERSION} variable with the latest version of our DevKinsta Docker image:

docker run --network devkinst_network --name devkinsta_nginx \\
-p 80:80 -p 443:443 \\
-v "[YOUR_HOME_PATH]/kinsta:/kinsta" \\
-v "[YOUR_HOME_PATH]/logs:/www/kinsta/logs" \\
-v "[YOUR_HOME_PATH]/private:/www/kinsta/private" \\
-v "[YOUR_HOME_PATH]/public:/www/kinsta/public" \\
-v "[YOUR_HOME_PATH]/ssl:/www/kinsta/ssl" \\
-d kinsta/devkinsta_nginx:${LATEST_IMAGE_VERSION} \\

On Windows, you can use the same command without the linebreaks and the \\ separators.

To get the latest version of our images, run:

docker image ls --filter=reference='kinsta/devkinsta_*'

DK0056

Description: Could not update site URLs with new ports.

You may see this error if devkinsta_fpm is not running while trying to rename the site’s URLs after you selected the new ports.

Solution

Make sure that devkinsta_nginx and devkinsta_fpm containers are up and running.

DK0057

Description: We cannot display emails on computers with M1 chip.

Currently, our mail service used by DevKinsta doesn’t support M1 chips.

Solution

Use a different computer that doesn’t have an M1 chip to check emails for your DevKinsta site.

DK0058

Description: Failed to copy the site folder.

DevKinsta could not copy the files to the new folder when renaming the page.

Solution

Go to the DevKinsta/public folder. Delete the folder with the new site name and retry the renaming process in DevKinsta.

DK0059

Description: Failed to copy the database.

DevKinsta could not copy the database during site renaming.

Solution

Delete the newly created site’s database and retry the renaming process in DevKinsta.

DK0060

Description: Failed to update the database.

DevKinsta was unable to update the URLs, domains, and emails in the new site database when renaming the site.

Solution

Check if the database exists. If not, try to create it manually and copy the old site data.

DK0061

Description: Failed to delete the old site’s data.

You may see this error when DevKinsta tries to delete the old site’s data.

Solution

Retry the site renaming and ensure you provide the correct password.

DK0062

Description: Failed to add certification to the store.

You may see this error when DevKinsta tries to create a local certificate on the system for your site.

Solution

Retry the site renaming and ensure you provide the correct password. DevKinsta needs to be in Administrator mode on Windows.

DK0063

Description: Failed to restart a docker container

You may see this error when DevKinsta failed to restart a docker container.

Solution

You can restart the container manually in Docker Desktop or in terminal (replace <container> with the container name):

docker start <container>

DK0064

Description: Couldn’t remove remote files.

You may see this error when something changes in your remote environment that makes DevKinsta unable to perform the file deletion command (rm) on the remote site’s file system.

Such changes may be:

Permission changes (DevKinsta does not have permission to remove some files)
Folder structure changes (name of the remote site’s root folder has changed since the pull).

Solution

Try to pull the remote site again and apply the changes on the new site (e.g. copy and paste the modified files or database), then try to push again. If that doesn’t help, try logging out and logging back in again.

If the error persists, check the application log file (main.log). Searching for the error code (DK0064) in the log file can help narrow down the search and may lead to some more detailed information on the root cause.

DK0065

Description: Failed to upload local files

This error occurs whenever something is wrong with uploading the local site to the remote server (your MyKinsta environment’s folder). This can be caused by a failed connection to the remote server or unpredictable issues related to the uploaded files.

Note that this step uses rsync as a tool to share files with the remote site, so anything that can cause rsync to fail can be the root cause of this issue.

Solution

Try logging out of MyKinsta in DevKinsta, and then log back in. If it still doesn’t work, try to pull the remote site again and apply the changes on the new site (e.g. copy and paste the modified files or database), then try to push again.

If the error persists, check the application log file (main.log). Searching for the error code (DK0065) in the log file can help narrow down the search and may lead to some more detailed information on the root cause. If that search doesn’t show any useful information, then try searching for rsync.

DK0066

Description: Failed to import database dump

This error means that DevKinsta was unable to import the local database dump into your MyKinsta site’s database.

Possible root causes:

Local database dump was not created (very unlikely, because it would fail on Create MySQL dump step).
Your remote database does not exist or is down for some reason

Solution

Investigate your MyKinsta site’s database and file system to see if your database is working properly. If not, then there is an issue on the server side and our Support team can help with this.

If your site’s database is working properly, then there was likely an issue on the DevKinsta side. Investigating the application log file (main.log) may be helpful. Searching for the error code (DK0066) in the log file can help narrow down the search and may lead to some more detailed information on the root cause.

DK0067

Description: Failed to run search and replace

Search and replace is a WP-CLI command (WP-CLI is the command line interface for WordPress) that makes it possible to replace all occurrences of a string in the site’s database. We use it to overwrite the local site’s URL with the remote site’s original URL (to keep the site accessible after the push).

If the step is not functioning properly, then two things may be wrong:

WP-CLI is not available or working in your site’s folder on the remote server (MyKinsta)
Your remote database is down

Solution

Check to see if WP-CLI is working on your remote (MyKinsta) site. If WP-CLI works but reports database-related issues, then your site is not connecting to the database properly. Review the database settings in your site’s wp-config.php file and confirm the database details are correct.

If your remote database is down, contact our Support team to help resolve that issue.

If the solutions suggested above do not resolve the issue, then restoring a recent backup is recommended.

DK0068

Description: Failed to create site backups when trying to change ports.

We back up sites before we change the port so we can roll back in the event of an error.

Solution

The error is usually related to zipping or file system issues. The backup is created in the TEMP directory in the “backup” folder. Check to make sure the location exists and you have write permissions.

DK0070

Description: Failed to delete DNS record.

Couldn’t delete a site’s URL from the DNS server of the FPM container.

Solution

You can delete manually it manually (replace http://example.com with the URL you want to delete):

docker exec devkinsta_fpm dns_server delete -d http://example.com

DK0071

Description: Failed to add DNS record.

Couldn’t add a site’s URL to the DNS server of the FPM container.

Solution

Try to restart DevKinsta and click the Retry button. The DNS record should be created during the startup process.

DK0072

Description: Could not delete site config file

This error occurs when you try to delete or rename a site but DevKinsta cannot delete the sitename.conf file stored in DevKinsta/nginx_sites.

Solution

The most common reason this happens is due to permission issues, so you may need to manually delete the file.

DK0073

Description: Could not restart Nginx service

When a site is created, renamed, or deleted, the Nginx service needs to be restarted. This error appears if the restart fails.

Solution

To restart the Nginx container manually, open a terminal window and run the following:

docker stop devkinsta_nginx
docker start devkinsta_nginx

Checking Nginx logs or DevKinsta logs may provide more details as to why the restart failed.

DK0074

Description: Failed to create site backup.

The site backup is an archived (zipped) version of a site in the temp folder on your local computer. This error is rare and occurs only in edge cases such as running out of disk space or incorrect permissions on the temp folder.

Solution

Review permissions for your temp folder and check to make sure there is enough space on the disk, especially in the case of larger sites.

DK0075

Description: Failed to restore the site backup.

Restoration can fail if the site’s folder is not writeable for some reason. Another reason for failure can be that the zip creation was not successful when creating the backup.

Solution

Check if the site backup exists in the temp folder.
If the backup exists, then it can be manually extracted into the site’s folder.

To help prevent this issue, sync the site regularly to MyKinsta or use a version control system such as Git to track changes and allow you to restore from previous versions.

DK0076

Description: Couldn’t install WordPress plugin

DevKinsta couldn’t install a WordPress plugin for a given site. DevKinsta sometimes needs to install plugins.

Solution

If installation fails, it can be fixed by manually installing the plugin via WP-CLI.

DK0077

Description: Couldn’t remove WordPress plugin

DevKinsta couldn’t remove a WordPress plugin from a given site. DevKinsta sometimes needs to remove plugins.

Solution

If the removal fails, it can be fixed by manually removing the plugin via WP-CLI.

DK0078

Description: Couldn’t update WordPress option

DevKinsta couldn’t update one of the WP options in the site database using a WP-CLI command.

Solution

If the update fails, it can be fixed by manually updating the option via WP-CLI.

DK0081

Description: Parsing wp-config.php file failed.

You may see this error when importing a site backup file if one of the following happens:

wp-config.php not found
This means DevKinsta cannot find wp-config.php file in the backup.
Invalid database settings. Cannot find DB_NAME variable
This means DevKinsta couldn’t extract the database name out of wp-config.php.
{dbName}.sql not found
This means wp-config.php is okay, but the database backup file cannot be found in the folder or zip file.

Solution

In any of the above situations, check the site backup file and make sure:

wp-config.php exists in the root folder.
The define( 'DB_NAME', '{dbName}' ); line exists in the file.
A .sql file named exactly as mentioned in config file {dbName}.sql exists in the root folder.

DK0082

Description: Load remote file system error.

This error occurs when DevKinsta fails to load the file system tree of the remote site when doing a selective pull. The error is usually caused by an SSH key issue.

Solution

Try logging in again. If the error persists, remove your “.ssh” folder and try to log in again. If that doesn’t work, contact our Support team to help resolve that issue.

DK0083

Description: Volume path is not supported.

Volume path is not supported.

Solution

Check the paths of the volume on your computer. If the path is not supported, update Windows or Docker.