Your first OneStop
installation on Ubuntu.

Check what you need.

• The installer targets Ubuntu Desktop or Server 24.04 / 26.04 LTS, amd64 (x86-64), with systemd running. ARM devices, containers and other distributions are not supported by this installer.
• Allow at least 4 GB RAM, plus free disk space for OneStop, its scanner and your files.
• You need an Ubuntu account allowed to use sudo and its password. This is the computer's administrator password, not your future OneStop password.
• Keep an internet connection available. Installation downloads Ubuntu packages, application dependencies and antivirus definitions. This is not an offline installer.

Desktop or headless server? The main walkthrough uses Ubuntu Desktop so you can open Terminal and a browser on that same computer. If using a headless server over SSH, run server commands in that server's SSH session and plan HTTPS access before installation. A browser on your Windows PC cannot reach the server using localhost.

Save both files on Ubuntu.

1. Open this guide in the Ubuntu computer's browser.
2. Download the Ubuntu archive and the SHA-256 file using the links above. Keep both in the same Downloads folder.
3. Open Files → Downloads and check that you have OneStop-Ubuntu-2.1.75-desktop-sync-amd64-preview.tar.gz and OneStop-Ubuntu-2.1.75-desktop-sync-amd64-preview.tar.gz.sha256. If the checksum opens as text in the browser, save that file with its exact name.

The .tar.gz file is a compressed package, not a Windows program. Do not rename it to .exe. If you downloaded on another computer, transfer both files to the Ubuntu test machine first.

Open Terminal and verify the download.

On Ubuntu Desktop, open the applications menu and search for Terminal. Copy each command below into Terminal and press Enter. Pasting commonly uses Ctrl+Shift+V. Run these on Ubuntu—not in Windows PowerShell.

cd "$HOME/Downloads"
ls -lh OneStop-Ubuntu-2.1.75-desktop-sync-amd64-preview.tar.gz*
sha256sum --check OneStop-Ubuntu-2.1.75-desktop-sync-amd64-preview.tar.gz.sha256

If your download folder has a different name or location, replace $HOME/Downloads with that actual folder path. The cd command changes folders; ls lists the downloaded files; sha256sum checks the archive.

Continue only when the archive is reported “OK”.

If it says FAILED, a file is missing, or the name ends with an added (1), stop and check the exact filenames. Download again if needed. Do not skip verification to get past an error.

Extract the package and install the server.

From the same Terminal, create a fresh folder and unpack the archive:

mkdir OneStop-Ubuntu-2.1.75-preview
tar -xzf OneStop-Ubuntu-2.1.75-desktop-sync-amd64-preview.tar.gz -C OneStop-Ubuntu-2.1.75-preview
cd OneStop-Ubuntu-2.1.75-preview
less README.md

Read the package instructions. Press q to leave the README viewer. If the extraction folder already exists, use a new empty folder name in all three commands; do not extract over a previous attempt.

For your first local test with a browser on this same Ubuntu computer, run:

sudo bash install.sh

1. Enter your Ubuntu account password when sudo asks. It is normal for no letters or dots to appear while typing. Press Enter.
2. Read the agreement and type ACCEPT only if you agree.
3. Let setup finish downloading dependencies and setting up services. Do not close Terminal midway. If it fails, keep the error and see troubleshooting.
4. Note the local address and port printed by setup. Port 3001 is the default; it may choose the next free port through 3010.

If installing a headless/network server, use the appropriate HTTPS command in step 7 instead of the local-mode command. Existing installations retain their configuration; rerunning with another mode is not a guaranteed way to change an existing address.

Open OneStop and create your account.

1. On the Ubuntu server's own desktop, open a browser and enter the address printed by setup—normally http://localhost:3001. Use the selected port if different.
2. In Terminal, display the first-account setup code:

sudo cat /var/lib/onestop/setup-code.txt

3. Copy that private, one-time code into the setup page. Never share it in chat or support tickets.
4. Choose your administrator username and a unique password of 15–128 characters. Save recovery codes somewhere safe outside this OneStop server.
5. Sign in. The administrator can create additional users in Settings. Use the permanent HTTPS address when registering passkeys for remote access.

If the setup code is missing or a sign-in page already appears, check whether an administrator already exists. Do not erase the database to repeat initial setup.

Check the services and try one file.

In the Ubuntu Terminal, run:

sudo systemctl status onestop onestop-scanner --no-pager
sudo journalctl -u onestop -u onestop-scanner --since today --no-pager

The services should be active, and the logs should not show repeated startup failures. Service status alone does not prove the scanner and website work: sign in, upload a small non-sensitive file, wait for scanning, then download and open it. Also create a test task and refresh the page.

In HTTPS mode, also check:

sudo systemctl status onestop-proxy --no-pager

That optional proxy service is not needed for local-only mode. Keep the installation on test data until Linux installation, reboot, backups and restore have been validated on your machine.

Make it reachable from another device.

Local mode is not remote access. On a second PC, localhost points to that second PC, not your Ubuntu server. Desktop Sync and phone apps need a permanent, trusted HTTPS server address.

Public HTTPS

Arrange a hostname you control, DNS pointing to the server's public address, and inbound TCP 80/443 reaching it. Ask for help if you are unfamiliar with router/firewall configuration or your provider uses CGNAT. Then, from the extracted server package, replace the example address with your real hostname:

sudo bash install.sh --mode public --origin https://files.example.com

Internal HTTPS

For an internal network, choose a permanent hostname that your client devices resolve to this server. Replace the example:

sudo bash install.sh --mode internal --origin https://files.example.com

Clients must trust the installation's private certificate authority. Its public root certificate is /var/lib/onestop-proxy/certificates/pki/authorities/local/root.crt. Follow your device's certificate-trust process with administrator help. Distribute only the public root certificate, never a private key. Do not ignore certificate errors.

Add Desktop Sync to your computer.

The Ubuntu server bundle includes Windows Desktop Sync 2.1.7 and Linux Desktop Sync 1.0.0 preview. They are client downloads inside your installed server, not two more servers. Phone apps are separate.

On a Windows desktop

Sign in to your Ubuntu-hosted OneStop website, open Settings → Desktop & phones, and download Windows Desktop Sync. Follow the Windows client walkthrough. You do not need the Windows server installer.

On an Ubuntu desktop

1. Use Ubuntu Desktop x64 with a graphical session. The Linux client is not a headless system service. Your desktop's Secret Service keyring must be available and unlocked.
2. In that desktop's browser, sign in to OneStop and open Settings → Desktop & phones. Download Linux Desktop Sync and check its displayed checksum. Save it in Downloads.
3. Open Terminal on the desktop computer you want to sync. Install its prerequisites:

sudo apt update
sudo apt install python3-tk libsecret-tools

A Secret Service provider such as the desktop's normal GNOME Keyring is also required. If no keyring is available, stop and get desktop-setup help; do not store credentials in a plain-text file.

4. Extract the client into a new folder, read its README, then install it as your signed-in desktop user:

cd "$HOME/Downloads"
mkdir OneStop-Desktop-Sync-1.0.0-preview
tar -xzf OneStop-Desktop-Sync-1.0.0-linux-x64-preview.tar.gz -C OneStop-Desktop-Sync-1.0.0-preview
cd OneStop-Desktop-Sync-1.0.0-preview
less README.md

Press q after reading, then run:

bash install.sh

Do not use sudo for the Desktop Sync client installer. The server's earlier installer needs sudo; this per-user desktop client does not.

5. Open OneStop Desktop Sync from the applications menu.
6. In the server's Settings choose Pair desktop sync. In the client, enter the same trusted HTTPS server address, its one-use pairing code, and a dedicated local folder. Choose a new empty folder for your first test, not your home folder or another sync product's folder.
7. Select Connect. Test with one disposable file and verify it appears in OneStop's Files section.
8. Minimize the Linux client to keep it syncing. Closing its window stops sync, unlike the Windows tray client. Pause/resume and optional startup at desktop login are available.

Common problems, without guesswork.

• “No such file or directory”: run pwd to see your current folder and ls to list files. Check the download location, spelling and capitalization. Linux names are case-sensitive.
• “Not in the sudoers file”: use an authorized Ubuntu administrator account. Do not change system permissions blindly.
• Browser cannot connect: check the setup address, selected port and services. Confirm you are browsing on the server itself for local mode.
• Scanner unavailable or uploads blocked: check network access and antivirus definitions. Do not disable scanning or AppArmor to suppress the error.
• Installation failed: review the installer log below and the journal commands from step 6. Share only redacted error messages.

sudo tail -n 80 /var/log/onestop-install/install.log

Data and future upgrades

Application files live under /opt/onestop. Configuration, database, encryption keys and the default encrypted library live under /var/lib/onestop. Do not delete or publicly share them.

Before upgrading, follow and test the bundled backup/restore procedure. Download the new release, verify it and extract it into a new folder, then follow that release's upgrade instructions. Existing configuration and data are retained; failed upgrades can leave services stopped and there is no automatic database downgrade. Do not copy a Windows installation into Ubuntu as an assumed migration.

Read the full package instructions for backup/restore, certificate trust and qualification limits. Contact Greenlyz support with your Ubuntu version, OneStop build and redacted error text. Never send setup codes, passwords, recovery codes or private files.