Installation

This section guides you through downloading and installing the OneServer desktop application on your operating system.

System Requirements

OneServer is designed to run on the following desktop operating systems:

• macOS (Apple Silicon & Intel architectures supported)
• Windows (x64)
• Linux (x64 - primarily tested on Debian-based distributions like Ubuntu)

Ensure you have sufficient permissions to install applications on your system.

Downloading OneServer

The latest version of OneServer, along with previous releases, can be downloaded directly from the official website:

1. Navigate to oneserver.ai and click Download.
2. Select the appropriate link for your operating system:
   • macOS: Look for a .dmg file
   • Windows: Look for a .msi file
   • Linux: Look for a .deb or an .AppImage file

Installing OneServer

Follow the standard installation procedure for your operating system:

macOS (.dmg)

1. Double-click the downloaded .dmg file to open it.
2. A window will appear showing the OneServer application icon and usually a shortcut to your Applications folder.
3. Drag the oneserver icon into the Applications folder.
4. You can now eject the mounted .dmg image (like ejecting a USB drive) from Finder.
5. Launch OneServer from your Applications folder or using Spotlight search.
6. Note: On the first launch, macOS might ask you to confirm opening an application downloaded from the internet. Click “Open”.

Windows (.msi)

1. Double-click the downloaded .msi file.
2. The Windows Installer wizard will launch. Follow the on-screen prompts.
3. Typically, you will need to accept the license agreement (if any) and confirm the installation location.
4. Click “Install” and grant administrator permissions if prompted.
5. Once the installation is complete, click “Finish”.
6. OneServer should now be available in your Start Menu.

Linux (.deb - for Debian/Ubuntu/Mint etc.)

1. Graphical Method: Double-click the downloaded .deb file. Your system’s software center should open, allowing you to click an “Install” button. Enter your password when prompted.
2. Terminal Method:
   • Open a terminal in the directory where you downloaded the file.
   • Run the command: sudo dpkg -i oneserver_*.deb (replace * with the actual version/architecture).
   • If you encounter dependency errors, run: sudo apt-get install -f
   • OneServer should now be available in your application menu.

Linux (.AppImage - Universal)

1. Make Executable: Right-click the downloaded .AppImage file, go to Properties -> Permissions, and check the box allowing execution. Alternatively, use the terminal: chmod +x oneserver_*.AppImage
2. Run: Double-click the .AppImage file to run it directly. You can also run it from the terminal: ./oneserver_*.AppImage
3. Optional: You might be prompted to integrate the AppImage with your system (creating a menu entry). This is recommended for easier access. If not prompted, tools like “AppImageLauncher” can help manage AppImages.