Installation guide

Before you begin, make sure your server meets the minimum requirements. Remmy is lightweight by design and runs comfortably on modest hardware.

Supported operating systems:

• Ubuntu 22.04+ / Debian 12+
• Windows Server 2019+

Minimum hardware:

• 2 CPU cores (4 recommended)
• 4 GB RAM (8 GB recommended)
• 20 GB free disk space
• Port 443 (HTTPS) open to managed devices

For fleets under 100 devices, the minimum specs are more than enough. Scale up CPU and RAM as your fleet grows beyond that.

After purchasing a license or starting a trial, you'll receive a license key and access to the download portal. Download the installer package for your operating system.

Linux: Download the .deb or .tar.gz package from your account portal. The .deb package is recommended for Ubuntu and Debian systems as it handles dependencies automatically.

Windows: Download the .msi installer from your account portal. Run the installer as Administrator and follow the setup wizard.

Linux installation:

Upload the package to your server and install it using your package manager:

sudo dpkg -i remmy-server.deb

sudo apt-get install -f

The installer creates a remmy system service, sets up the database, and configures default settings.

Windows installation:

Run the MSI installer as Administrator. The wizard will guide you through choosing an install directory, configuring the database location, and setting up the Windows service.

After installation, open your browser and navigate to https://your-server-ip. You'll be greeted by the setup wizard which will walk you through:

• Creating your admin account - Set your username, email, and password.
• Entering your license key - Paste the key from your purchase confirmation or trial signup.
• Configuring basic settings - Set your organization name, timezone, and default notification preferences.
• SSL certificate - Remmy generates a self-signed certificate by default. You can replace it with your own certificate from the Settings page later.

Once setup is complete, verify everything is working:

1. Log in to the Remmy dashboard with your admin credentials.
2. Check the System Status card on the dashboard - all services should show green.
3. Navigate to Settings > Server to confirm your license is active.
4. Try downloading an agent installer from Devices > Add Device to confirm the agent download service is running.

Your Remmy server is ready. Here's what to do next:

• Add your first device - Deploy the Remmy agent to a computer and see it appear in your dashboard.
• Invite your team - Create user accounts for your IT staff from the Users page.
• Explore the dashboard - Get familiar with the KPI cards, navigation, and key features.