bits & crumbs — cookie and binary logo
← ByteBridge overview

Desktop · Windows and Linux

Mount your server files.

Open a remote PDF in your usual reader, edit a file from Explorer or Linux Files, or share a local folder back to Web.

ByteBridge Desktop window with its native View menu open
ByteBridge Desktop · Native View menu
Windows
x64 portable ZIP
Linux
amd64 Debian package / x64 archive
Requires
HTTPS Web server and Desktop entitlement for mounts

Connect a desktop and share a local folder

Use a native mount to open a server file in an application on your computer. Desktop Bridge lets Web browse a folder shared by your computer. You can use both with the same server.

Save the server and sign in

  1. Install the Windows x64 or Linux x64 package. Open ByteBridge Desktop → Saved servers → + Add server. Enter a name and the root HTTPS address you use for Web. Choose Save server.
  2. Choose Test on that server's card. The result shows the Web version and response time. Choose Open and sign in with your Web account. Desktop maintains its own session for each server.
  3. For faster sign-in, select Remember password on this device over HTTPS. Then use Edit → Desktop PIN settings on the server card to set a 6–12 digit PIN. Next time, choose PIN or password when opening the server. Linux needs an available system keyring to remember passwords.
  4. For native mounting and Desktop Bridge sharing, the selected server needs a valid Desktop entitlement. An administrator can open Web Settings → Server license on that installation and import its signed license. One installation covers its clients. A second server that you mount needs its own entitlement. The Web workspace itself is free to use.

Make a computer folder available in Web

  1. In the Desktop launcher choose Shared local folders → + Pair computer. Select your saved HTTPS server, name the computer, and sign in or unlock your Desktop PIN.
  2. Choose Choose folder and select a folder such as Documents/Project. You can also start the picker at Add Home folder or Add Documents folder. Selecting an entire home directory includes its hidden files. Select the smallest folder that contains what you want to share.
  3. Shared folders start read-only. Choose Allow writes on a folder if you want changes from ByteBridge, including deletes, to reach this computer. Choose Start sharing.
  4. Refresh connections in Web, open the computer's Desktop Bridge card and browse the selected folder. Keep the computer awake and Desktop running. The bridge connects out over secure WebSocket. Closing the window keeps it in the tray. Stop sharing takes the computer's folders offline.

Check the connection. A successful server test confirms the Web endpoint responds. If shared folders remain offline, check that sharing has started, that the computer can reach the HTTPS address and that the reverse proxy forwards WebSocket upgrades. If you changed the server origin, pair the computer again.

Mount a connection in Windows Explorer

  1. On Windows x64, fully quit any older Desktop instance from the tray. Extract the complete Windows ZIP into a new folder and launch ByteBridge.exe from it. Keep the companion files alongside the executable. The launcher badge shows the installed Desktop version.
  2. Install WinFsp 2.1 or a compatible newer 2.x runtime, including its managed .NET component. If Desktop reports a missing runtime, use Install WinFsp, then Check again. Run Desktop as your ordinary Windows user.
  3. After saving your server, choose Mounted drives → + Mount drive. Select the HTTPS server, sign in if prompted, then choose an existing file connection. Accept the suggested Mount root directory or choose an authorized subfolder.
  4. Choose an unused Drive letter from D–Z and a Volume label. For browsing an archive, enable Read-only. For editing, the connection and your server account must also allow writes. Choose Save and mount.
  5. When the card shows Mounted, choose Open in Explorer. Open a PDF in your usual reader. On a writable mount, create a small text file, save it, close the editor, and refresh the same folder in ByteBridge Web to verify the change reached the server.

Restore the drive. Select Mount when Desktop starts for a recurring workspace. Remember sign-in for mounts on this device allows reconnection without a PIN under your OS account. Otherwise, unlock when prompted. Use Reconnect after connectivity returns. Save and close open files before unmounting.

Windows and Linux now share the server-card controls and mount editor. Current builds reuse supported server readers and fetch nearby document bytes as needed when opening PDFs. Opening time still depends on your storage connection and network. A Windows directory with names that differ only by case can require renaming a file through Web before Explorer can list it.

Mount a connection in Linux Files

  1. On Ubuntu or Debian x64, quit any running Desktop instance. In the directory containing the downloaded package, install its exact filename. For the 0.1.37 package, run
    sudo apt install ./ByteBridge-Desktop-0.1.37-linux-amd64.deb
    Open ByteBridge Desktop from the application menu as your normal user. The Debian package installs the FUSE 3 runtime dependencies.
  2. After saving your server, open Mounted drives → + Mount drive. Select the HTTPS server and connection. Leave Mount root directory at its suggested value, or restrict it to the remote folder you need.
  3. For Mount folder, use an empty, user-owned directory under your home, such as ~/ByteBridge/Archive. Desktop can create it. An existing mount, symlink or directory writable by other users is rejected. Choose Read-only if desired, then Save and mount.
  4. Choose Open in Files or list the folder from a terminal:
    ls -la "$HOME/ByteBridge/Archive"
    Open a document in your usual app. On a writable connection, save and close a sample file, then refresh its folder in Web. Writes are committed remotely when the application flushes or closes the file.

Unmount cleanly. Close documents, move terminal sessions out of the mounted folder, then choose Unmount on the drive card. A busy mount stays attached so you can release it and retry. The empty directory remains for next time. Mount when Desktop starts restores the mount at application launch. You can configure login startup separately in your desktop environment.

If mounting fails. Check that the current user can access /dev/fuse, the mount directory is empty, the server's HTTPS certificate is trusted, and this server has an eligible license. For a connection outage, restore connectivity and choose Reconnect. Browsing and saving mounted files require the remote server to be reachable.

03 / COMMON ISSUES

Troubleshooting

Test cannot reach the server.

Open the same root URL in your browser and confirm the client can reach the instance. Desktop checks /healthz. Use a trusted HTTPS certificate and keep any required LAN or VPN connection active.

My Linux launcher no longer opens.

If you moved the extracted folder, rerun ./install-launcher.sh in the new location. The launcher also needs the usual Electron libraries, including GTK 3 and NSS, and a working Chromium sandbox.

What does Forget remove?

Forget closes that server’s Desktop windows and clears its local session data. Your Web account and saved server-side data stay on the ByteBridge instance.

KEEP GOING

Open an approved folder in VS Code.

Open guide