winboat icon indicating copy to clipboard operation
winboat copied to clipboard

[Bug] Winboat Guest API Offline

Open DjagbleyEmmanuel opened this issue 2 months ago • 19 comments

What version of WinBoat are you running?

v0.8.7

Your Environment

OS: Linux Mint 22.2 x86_64 Kernel: 6.8.0-85-generic DE: Cinnamon 6.4.8 WM: Mutter (Muffin) Name Application ID Version Branch Origin Installation FreeRDP Client com.freerdp.FreeRDP 3.17.2 stable flathub system

Steps to Reproduce / Context

Launch winboat and try starting container

Logs

no logs

Expected Behavior

Image

Current Behavior

Container runs perfectly fine except guest API is offline for some reason

Possible Solution

No response

Quality Notice

  • [x] I have checked the issue tracker and verified that this bug is a unique case.

DjagbleyEmmanuel avatar Oct 17 '25 01:10 DjagbleyEmmanuel

Could you follow the steps mentioned in the guide that opens when you click that little question mark next to the "Guest API - Offline" label and report back?

Levev avatar Oct 17 '25 10:10 Levev

I would like to report that I am having this same issue. I tried all of the steps listed and none of them worked.

I am running Fedora 42 KDE, kernel 6.11

My app shows "Container - Created" instead of "Container - Running" but I am able to log into the container and use it like a normal desktop

desl8 avatar Oct 17 '25 15:10 desl8

Image Image

It goes on and on. Btw, on first Install it worked without any issues but then i had to exit the container and tried launching it again to check something (Gut feelings that something would break)

DjagbleyEmmanuel avatar Oct 19 '25 15:10 DjagbleyEmmanuel

Image

Here's the Folder for Winboat.

DjagbleyEmmanuel avatar Oct 19 '25 15:10 DjagbleyEmmanuel

@DjagbleyEmmanuel I was able to fix the issue by going into settings and resetting winboat. Don't forget to docker rm the container!

desl8 avatar Oct 19 '25 15:10 desl8

@DjagbleyEmmanuel I was able to fix the issue by going into settings and resetting winboat. Don't forget to docker rm the container!

Detailed steps would be very much helpful

DjagbleyEmmanuel avatar Oct 19 '25 15:10 DjagbleyEmmanuel

Run following command to get docker container's error & search for it docker logs WinBoat

Amr-Elsadek avatar Oct 19 '25 22:10 Amr-Elsadek

I have the same problem.

Image

Quick911 avatar Oct 20 '25 03:10 Quick911

Image

Quick911 avatar Oct 20 '25 03:10 Quick911

It keeps trying to download windows os for install every time i launched Winboat when i already had it installed, and worked flawlessly on first run. how do i know this? I follow this link ((Use VNC at http://127.0.0.1:8006/ to access the Desktop))

PS: just a thought, I had it (Windows 11) installed on a separate drive partition, could that be the problem? storage's running low on my home partition so i chose another drive, an NVME?

DjagbleyEmmanuel avatar Oct 22 '25 07:10 DjagbleyEmmanuel

@DjagbleyEmmanuel I was able to fix the issue by going into settings and resetting winboat. Don't forget to docker rm the container!

That did the trick for me as well, thanks !

CorentinWicht avatar Oct 22 '25 11:10 CorentinWicht

If you still would like to go Over the API and log in over the freerdp than what works for me is i login like you over the VNC and then navigat on your winboat-machine to C:\Program Files\WinBoat\resources\winboat_guest_server\ and there i start the winboat_guest_server.exe

It will open a Terminal, just let it run and minimize it. after one or two minutes the API works than fine for me.

hope this helps.

cheers

PS: this is also not an permanent fix. you have to do this after every startup.

wolf89-cmd avatar Oct 23 '25 13:10 wolf89-cmd

You should start it as a service in the windows service manager.

Levev avatar Oct 23 '25 17:10 Levev

Well, I've similar issue as @DjagbleyEmmanuel. Guest API offline after some days of successful playing with Winboat ;-)

First: Same Linux and Winboat version as Emmanuel... What version of WinBoat are you running: v0.8.7 Your Environment OS: Linux Mint 22.2 x86_64

It happened to me after applying an update to "docker-compose-plugin" from version 2.40.1-1 to 2.40.2-1-ubunto.24.04-noble. Maybe that's related?

Anyway, I've started VNC view and noticed, that Winboat is again downloading and installing Windows. This ended in a blank fresh Windows - without all of my installed software inside it of course. Even though being under developement, somehow disappointed admittedly ... :-(

I'm going to stop my experiments with Winboat for now as I still have other options to run my Windows software on but wanted to share my observation while hoping it may help to mature this great project!

curlyel avatar Oct 27 '25 11:10 curlyel

Can confirm the same on Pop!_OS 22.04 LTS. The VNC view keeps downloading and redownloading windows.

anarchy1923 avatar Oct 27 '25 16:10 anarchy1923

Image Here's the Folder for Winboat.

I see you installed it on another drive instead of your main drive. I think WinBoat doesn't support installing from/to other drives (I have a mildly similar problem #429). Installing it on main drive AND having the ISO file there too is a workaround (like having the ISO on home folder and WinBoat folder in home too, as an example).

What I did to not lose my data on a new install:

  1. Copy your current data.img folder to another drive as a backup.
  2. Reset container from WinBoat settings.
  3. Install again following previous indications and with the same iso you used previously but in your home folder or other place in your main drive. WinBoat folder should follow the same indication. (It could be necessary to configure the same user and password)
  4. Wait for windows to install. After it's done, terminate the container and go to your WinBoat folder, delete the new data.img file.
  5. Copy your previous data.img file and then you can use your previous system.

gaboUTN34 avatar Oct 29 '25 20:10 gaboUTN34

@gaboUTN34 Trying now, i tell you how it went. Thanks 

DjagbleyEmmanuel avatar Oct 29 '25 20:10 DjagbleyEmmanuel

Same issue here with Ubuntu 24.04.3 after 3 days of successfull testing, suddenly WinBoat Guest API - Offline. Resetting and reinstalling winboat (0.8.7), and docker delivers the error below while installing windows.

ERROR | Error: Command failed: docker compose -f /home/bo/.winboat/docker-compose.yml up -d

Terminal docker check: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 151f9d52fbfd ghcr.io/dockur/windows:5.07 "/usr/bin/tini -s /r…" 5 minutes ago Created WinBoat

so I restarted the docker container: docker restart 151f9d52fbfd Container is now running (green) but Winboat Guest API remains offline (red)

Update: I had to wait until the windows was reinstalled. Then everything works fine again.

Update 2: Today, same story again. Winboat and container remaining in red. I tested the docker manually and it saisd that I removed the windows-iso file (which I did...) I replaced it back under the winboat directory et voila, everythings works again. So the windows iso file remains necessary, also after installation of windows by winBoat.

mebogh avatar Oct 31 '25 23:10 mebogh

not a fix but this just worked:

-Follow every step in the guide (the one you find by clicking in the question mark when Winboat Guest API is offline) -When you copy-paste the winboat_guest_server.zip content you must:

  1. Add "C:\Program Files\Winboat" to the Windows Security exceptions
  2. Run install.bat & windows_guest_server.exe

Guest API should go online and should work whenever you launch winboat again

I just had this issue after modifying settings in windows firewall/security, have no idea what causes this nor if its related but windows security stopped me from launching guest_server.exe before i added it to the exceptions

had this issue in Arch with "Linux 6.17.6-zen1-1-zen" Kernel, Winboat Beta v0.8.7 running Windows 11, I don't think this has anything to do with the bug but could be useful for when it gets investigated

fnxwarehouse avatar Nov 02 '25 12:11 fnxwarehouse

I had the problem where the API was offline AND the container exited (I am running Linux Mint 22.2 Cinnamon). The reason for the problem was that I (accidentally) removed the Windows ISO from the WinBoat directory. I replaced the Windows ISO back into the WinBoat directory and my problem was solved.

Basedadamite avatar Nov 11 '25 18:11 Basedadamite

Finally got everything working! I ended up doing a clean Linux installation, made enough space on my home partition, downloaded the new alpha version, and installed it there. I’m still not sure what exactly fixed the issue.. 🤔 was it the clean install, the Winboat Alpha version, or the fact that this time I installed the Windows OS on the same partition (Home) as the Winboat software instead of a separate one? I guess I’ll never know. But overall, I’m grateful. Thanks to everyone who shared their solutions and to the creators of Winboat as well. All the best!

DjagbleyEmmanuel avatar Nov 14 '25 16:11 DjagbleyEmmanuel