How to Reinstall Incus Agent

Last updated October 16, 2025

Introduction

This is a short guide on how to restart the missing VM agent. The VM agent is necessary for the Webdock dashboard functions like adding shell users and WebSSH to function.

The instructions in this guide will help you bring up the agent.

Prerequisites

  • SSH access to your server or access to rescue console

Reinstalling the VM agent

Webdock servers use the Incus hypervisor. Hence the VM agent is also called “Incus Agent”. Run the below commands as a root user in an SSH session or in rescue console to try bringing up the agent.

mount -t 9p config /mnt
cd /mnt
./install.sh

The above commands are taken from the official Incus documentation.

In most cases, the above commands should help bring the agent online. You can verify if the commands worked by running “df -h” on the commandline. You should see something like this.


Notice the “/run/incus_agent”? That’s the sign that the Incus agent is working.

If running the above commands throws errors, then some changes you have done on the server previously caused the agent to fail and server is somehow broken. In this case you need to either restore using a snapshot or reinstall the server entirely.

Conclusion

Hope this article helped you bring the agent up and running on your server. Contact Webdock Support if you need any assistance with this.

Related Articles

Content
expand_more
chat box icon
Close
combined chatbox icon

Welcome to our Chatbox

Reach out to our Support Team or chat with our AI Assistant for quick and accurate answers.
webdockThe Webdock AI Assistant is good for...
webdockChatting with Support is good for...