Start here · Windows
Install OneStop.
One step at a time.
Set up your own OneStop server, create your first account, then connect Windows Desktop Sync if you want your files synchronized with a PC.
Instructions for OneStop Server 2.1.75 and its included Windows Desktop Sync 2.1.7. Guide updated September 27, 2026. For a different release, check its bundled instructions too.
Choose the server computer.
- Use Windows 11 x64 or Windows Server 2022 or newer, x64, with an administrator account.
- Keep this computer powered on and connected whenever you want other devices to reach OneStop.
- Have free space for the application and your library. Use a dedicated folder on a local NTFS disk; do not put the database on a network share.
- Have internet access for security updates and antivirus definitions. You do not need to install Node.js or run developer commands.
- If upgrading an existing server, make and test a OneStop backup before running the new installer. Do not uninstall or delete its data first.
This guide assumes Windows is already installed. It does not reinstall Windows or erase a disk.
Download and check the installer.
- On the chosen Windows computer, use the download button above. The website may save it as
OneStop-Setup.exe; a release copy can instead be namedOneStop-Setup-2.1.75-x64.exe. - Open your Downloads folder and find the file. In File Explorer, use Copy as path on that file.
- Open PowerShell. Type
Get-FileHash -Algorithm SHA256 -LiteralPath, paste the quoted path, then press Enter. For example, if it has the website's default name:
Get-FileHash -Algorithm SHA256 -LiteralPath "$env:USERPROFILE\Downloads\OneStop-Setup.exe"Compare the complete hash with the published checksum for the download. Letter case does not matter. If it differs, stop and download again; do not run it. The website checksum follows the current Windows release, not archived older installers.
Run the setup wizard.
- Right-click the verified installer and select Run as administrator. Approve the Windows administrator prompt only for the file you verified.
- Read the agreement and accept only if you agree.
- For a first trial on this computer, choose This computer only (localhost). To use phones or another computer, read network access before choosing a permanent HTTPS address.
- At Choose storage location, choose a dedicated local folder for encrypted files. The default is
C:\ProgramData\OneStop\storage. Keep that disk connected; existing installations retain their current storage location. - Complete the wizard and wait for service setup to finish. Keep any error message if setup fails.
- Use the Start menu's Open OneStop shortcut. In local mode this is normally
http://localhost:3001; if that port is occupied, setup can select 3002–3010. The shortcut uses the configured address.
The application is installed under C:\Program Files\OneStop. Configuration, database and encryption keys are under C:\ProgramData\OneStop. Do not delete that folder or share its contents.
Create the first administrator.
- Open Notepad as administrator. Choose File → Open, select “All files” if necessary, and open
C:\ProgramData\OneStop\setup-code.txt. - Copy the private setup code into OneStop's first-account setup page. It is not an email confirmation or a Stripe/API key. Do not send it to anyone.
- Choose your administrator username and a unique password of 15–128 characters.
- Save the recovery codes somewhere safe outside OneStop. If the computer or account becomes unavailable, do not rely on a copy stored only inside it.
- Sign in. The administrator can create additional users in Settings. Register remote passkeys only after choosing your permanent HTTPS address.
If a sign-in screen appears instead of initial setup, an account may already exist. Do not delete the database to bring setup back.
Try a small test before adding your library.
- Open Files and upload a small, non-sensitive test file.
- Wait for scanning to complete, then download it and open it.
- Create a test task or calendar event and refresh to check that it remains saved.
- Confirm the server and scanner report healthy before adding more files.
Success means you can sign in, store a test file, and retrieve it—not merely that setup has copied files.
Connect other computers and phones.
“localhost” means the computer you are currently using. Typing your server's localhost URL on a phone or a second PC will not reach that server.
- Internal HTTPS: use a permanent internal hostname and install the private certificate authority's public root certificate on client devices, following the bundled deployment instructions. Do not distribute a private key or ignore certificate warnings.
- Public HTTPS: use a domain you control, point DNS at the server's public address, and arrange inbound TCP ports 80 and 443. Router forwarding and firewall setup are not performed by the OneStop installer. Some internet connections use CGNAT and cannot accept direct inbound connections.
If you are new to DNS, certificates or router settings, get help before changing them. Do not stop another website, open all firewall ports, expose the scanner/backend, or place this computer in a router's DMZ. Settle on one trusted HTTPS address before pairing Desktop Sync or phone apps.
Set up Windows Desktop Sync.
Install this on each Windows computer whose local files you want to synchronize. You do not need to install another OneStop server there.
- In that computer's browser, sign in to your own OneStop server using its permanent, trusted HTTPS address.
- Open Settings → Desktop & phones and download Windows Desktop Sync. Older interface wording may say “Desktop sync & camera backup.” The client download comes from your installed server.
- Check its displayed checksum and run the Windows client installer. Open OneStop Desktop Sync.
- In server Settings choose Pair desktop sync. Verify your identity if asked. The pairing code is one-use and expires after ten minutes.
- In Desktop Sync enter that same HTTPS server address, choose a new dedicated local folder, and enter the code. Do not choose your entire user profile or a folder already managed by another sync application.
- Select Connect. Test with one disposable file, wait for it to appear in the server's Files section, then test a change from the website.
- Leave the tray client running. Closing its window keeps it running; choosing Exit in its tray menu stops it. Use Pause/resume as needed. The startup option starts it when that Windows user signs in.
If something does not work.
- Installer missing: check the browser's download history and actual Downloads folder. If antivirus quarantined it, leave it quarantined and contact support.
- Website will not open: use Open OneStop on the server itself. Check Windows Services for OneStop; do not terminate other Node processes or assume port 3001 was selected.
- Uploads remain blocked: inspect antivirus health and definition updates. Do not disable the scanner.
- Desktop Sync cannot connect: confirm the same trusted HTTPS URL, an unexpired pairing code and an available local folder. Fix certificate trust rather than bypassing verification.
- Need error details: review
C:\ProgramData\OneStop\logsandC:\Program Files\OneStop\install-service.log. Remove private details before sharing.
Updating later
Back up with the bundled tools\Backup-OneStop.ps1 procedure and test recovery first. Download and verify the next installer, then run it on the same server. Keep the existing data, storage folder and hostname. An older installer is not a safe database rollback. Check Desktop Sync updates separately in your server Settings.
Contact Greenlyz support with the release number and redacted error text. Never send passwords, setup codes, API keys, recovery codes or personal files.