wehub-resource-sync
3e779be6f3
CI / lint (push) Failing after 13m4s
CI / test (3.11, ubuntu-latest) (push) Failing after 2m4s
CI / test (3.13, ubuntu-latest) (push) Successful in 13m30s
CI / test (3.14, ubuntu-latest) (push) Successful in 17m21s
CI / test (3.12, ubuntu-latest) (push) Successful in 17m55s
CI / discover-apps-ps (push) Successful in 1m56s
CI / test (3.9, ubuntu-latest) (push) Successful in 13m17s
CI / test (3.10, ubuntu-latest) (push) Successful in 26m21s
CI / audit (push) Successful in 13m38s
Deploy site / deploy (push) Has been cancelled
CI / test (3.14, ubuntu-24.04-arm) (push) Has been cancelled
126 lines
12 KiB
HTML
126 lines
12 KiB
HTML
<!DOCTYPE html>
|
||
<!-- SPDX-License-Identifier: MIT — winpodx.org/faq. No trackers. -->
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
<title>FAQ — WinPodX</title>
|
||
<meta name="description" content="WinPodX FAQ: how it works, Windows licensing, performance, security & telemetry, which apps work, and how it compares to a VM, RDP, or Wine.">
|
||
<link rel="icon" type="image/svg+xml" href="assets/winpodx-icon.svg">
|
||
<link rel="canonical" href="https://www.winpodx.org/faq.html">
|
||
<meta name="theme-color" content="#0d1117">
|
||
<link rel="stylesheet" href="style.css">
|
||
</head>
|
||
<body>
|
||
|
||
<svg class="sprite" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
|
||
<symbol id="i-window" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M3 9h18"/></symbol>
|
||
<symbol id="i-swap" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M17 1l4 4-4 4"/><path d="M3 11V9a4 4 0 0 1 4-4h14"/><path d="M7 23l-4-4 4-4"/><path d="M21 13v2a4 4 0 0 1-4 4H3"/></symbol>
|
||
<symbol id="i-bolt" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9z"/></symbol>
|
||
<symbol id="i-hdd" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><line x1="22" y1="12" x2="2" y2="12"/><path d="M5.45 5.11L2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z"/><line x1="6" y1="16" x2="6.01" y2="16"/><line x1="10" y1="16" x2="10.01" y2="16"/></symbol>
|
||
<symbol id="i-activity" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></symbol>
|
||
<symbol id="i-lock" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="11" width="18" height="11" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/></symbol>
|
||
<symbol id="i-download" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="M7 10l5 5 5-5"/><path d="M12 15V3"/></symbol>
|
||
<symbol id="i-grid" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/></symbol>
|
||
<symbol id="i-cursor" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M3 3l7.5 18 2.5-7.5L21 11z"/></symbol>
|
||
<symbol id="i-github" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"/></symbol>
|
||
<symbol id="i-globe" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></symbol>
|
||
</svg>
|
||
|
||
|
||
<header class="nav">
|
||
<div class="wrap">
|
||
<a class="brand" href="/" style="color:var(--text)"><img src="assets/winpodx-icon.svg" alt="">WinPodX</a>
|
||
<nav class="links">
|
||
<a href="features.html" data-i18n="nav.features">Features</a>
|
||
<a href="get-started.html" data-i18n="nav.get_started">Get started</a>
|
||
<a href="faq.html" class="active" data-i18n="nav.faq">FAQ</a>
|
||
<a target="_blank" rel="noopener noreferrer" class="gh" href="https://github.com/kernalix7/winpodx"><svg class="isvg" width="16" height="16" viewBox="0 0 24 24"><use href="#i-github"/></svg> GitHub</a>
|
||
<span class="lang-wrap"><svg class="isvg" width="15" height="15" viewBox="0 0 24 24"><use href="#i-globe"/></svg><select id="lang-select" aria-label="Language"></select></span>
|
||
</nav>
|
||
</div>
|
||
</header>
|
||
|
||
<main>
|
||
<section class="page-hero wrap">
|
||
<span class="eyebrow" data-i18n="faq.hero.eyebrow">FAQ</span>
|
||
<h1 data-i18n="faq.hero.h1">Common questions</h1>
|
||
<p data-i18n-html="faq.hero.sub">Still stuck? Open an issue on <a target="_blank" rel="noopener noreferrer" href="https://github.com/kernalix7/winpodx/issues">GitHub</a>.</p>
|
||
</section>
|
||
|
||
<section class="wrap">
|
||
<div class="faq">
|
||
<details open>
|
||
<summary data-i18n="faq.q.vm.q">Is this a VM, Wine, or something else?</summary>
|
||
<div class="a" data-i18n-html="faq.q.vm.a">It's a real Windows VM presented as native windows. WinPodX runs Windows in a KVM-backed container (via <a target="_blank" rel="noopener noreferrer" href="https://github.com/dockur/windows">dockur/windows</a>) and surfaces each app as its own Linux window over FreeRDP RemoteApp (RAIL). So you get full Windows compatibility — unlike Wine — without staring at a full-screen Windows desktop.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.license.q">Do I need a Windows license?</summary>
|
||
<div class="a" data-i18n-html="faq.q.license.a">Same as any Windows VM: you need a valid Windows license to activate it for normal use. WinPodX automates the install but doesn't provide Windows or a license — those come from Microsoft.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.fast.q">How fast is it? Is it just remote desktop?</summary>
|
||
<div class="a" data-i18n-html="faq.q.fast.a">It's local RDP to a VM on your own machine over loopback — not a network connection to a remote server — so latency is minimal. Windows runs natively on KVM, and a host-adaptive tuning profile (<code>+invtsc</code>, <code>platform_tick</code>, etc.) is applied based on your CPU. The first launch takes ~5–10 min (Windows ISO download + Sysprep); subsequent launches are near-instant.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.telemetry.q">Does it phone home or collect telemetry?</summary>
|
||
<div class="a" data-i18n-html="faq.q.telemetry.a">No. WinPodX has <b>no telemetry of any kind</b> — no analytics, no usage tracking, no phone-home. It even disables Windows' own telemetry/ads/Cortana by default (debloat). It's MIT-licensed and the source is fully public.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.apps.q">Which apps work?</summary>
|
||
<div class="a" data-i18n-html="faq.q.apps.a">Anything that runs on Windows — Office, Adobe, niche enterprise tools, games' launchers, etc. By default, first boot adds the apps your Windows Start Menu shows — mirrored into matching folder sub-groups — each with its real icon. Turn on <code>desktop.full_app_scan</code> to also discover apps from the registry App Paths, all UWP/MSIX, Chocolatey and Scoop. You can add custom app profiles in the GUI or with <code>winpodx app</code>.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.reverse.q">Can Linux apps open from inside Windows too?</summary>
|
||
<div class="a" data-i18n-html="faq.q.reverse.a">Yes — that's "reverse-open". Your Linux apps appear in the Windows guest's "Open with…" menu with their real icons; picking one round-trips the file open back to the host's <code>xdg-open</code>. It's on by default. It can even open files on the Windows disk itself — the guest <code>C:</code> is shared over SMB and mounted with kio-fuse (KDE), so edits save straight back.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.peripherals.q">What about clipboard, sound, printers, and USB?</summary>
|
||
<div class="a" data-i18n-html="faq.q.peripherals.a">Clipboard (text + images), sound, printers, and your home directory (<code>\\tsclient\home</code>) are shared by default. USB drives are shared in-session at <code>\\tsclient\media</code> (with a desktop shortcut inside Windows), and there's live USB device passthrough (a host ↔ guest switcher) for things like security dongles.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.requirements.q">What are the requirements?</summary>
|
||
<div class="a" data-i18n-html="faq.q.requirements.a">A CPU with virtualization extensions + <code>/dev/kvm</code>, 8 GB+ RAM (12 GB+ recommended), ~30 GB free disk, a container runtime (<code>podman</code> ≥ 4 recommended; <code>docker</code> also works), and FreeRDP 3+. See <a href="get-started.html">Get started</a> for the full list and per-distro install.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.distros.q">Which Linux distros are supported?</summary>
|
||
<div class="a" data-i18n-html="faq.q.distros.a">openSUSE, Fedora (incl. Atomic/Silverblue/Kinoite), Debian, Ubuntu, RHEL / AlmaLinux / Rocky, Arch, and NixOS — plus a distro-agnostic AppImage. Install is one line on all of them.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.resources.q">Does the container keep running and eating resources?</summary>
|
||
<div class="a" data-i18n-html="faq.q.resources.a">No — it auto-suspends when idle and resumes on the next launch, and an opt-in idle auto-stop can fully stop the VM to free its RAM. You can also enable pod auto-start on login, or stop it entirely. A stalled RDP guest is detected and self-healed without a manual restart.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.uninstall.q">How do I uninstall? Will it wipe my Windows data?</summary>
|
||
<div class="a" data-i18n-html="faq.q.uninstall.a">One line: <code>curl -fsSL …/uninstall.sh | bash -s -- --confirm</code>. It keeps the Windows VM data by default; pass <code>--purge</code> to wipe everything.</div>
|
||
</details>
|
||
<details>
|
||
<summary data-i18n="faq.q.status.q">Is it stable? What's the project status?</summary>
|
||
<div class="a" data-i18n-html="faq.q.status.a">It's in active <b>beta</b> (v0.9.0) — usable day-to-day, with ongoing polish. Bug reports and PRs are welcome on <a target="_blank" rel="noopener noreferrer" href="https://github.com/kernalix7/winpodx/issues">GitHub</a>.</div>
|
||
</details>
|
||
</div>
|
||
</section>
|
||
</main>
|
||
|
||
<footer>
|
||
<div class="wrap">
|
||
<div class="cols">
|
||
<div><span class="brand" style="font-size:16px;font-weight:700;color:var(--text)">WinPodX</span>
|
||
<div class="footer-tagline" data-i18n="footer.tagline">Windows apps, as native Linux citizens.</div></div>
|
||
<div class="links">
|
||
<a href="features.html">Features</a><a href="get-started.html">Get started</a><a href="faq.html">FAQ</a>
|
||
<a target="_blank" rel="noopener noreferrer" href="https://github.com/kernalix7/winpodx">GitHub</a>
|
||
<a target="_blank" rel="noopener noreferrer" href="https://github.com/kernalix7/winpodx/releases">Releases</a>
|
||
<a target="_blank" rel="noopener noreferrer" href="https://github.com/sponsors/kernalix7">Sponsor</a>
|
||
</div>
|
||
</div>
|
||
<div class="legal" data-i18n-html="footer.legal">MIT licensed — Kim DaeHyun · Powered by
|
||
<a target="_blank" rel="noopener noreferrer" href="https://github.com/dockur/windows">dockur/windows</a> + <a target="_blank" rel="noopener noreferrer" href="https://www.freerdp.com/">FreeRDP</a>.
|
||
Not affiliated with Microsoft.</div>
|
||
</div>
|
||
</footer>
|
||
<script src="lang/translations.js"></script>
|
||
<script src="i18n.js"></script>
|
||
</body>
|
||
</html>
|