Introduction
Easy8 is a complex web-based project management application that requires a well-prepared environment to run reliably and efficiently. This includes specific combinations of hardware, software, and system configurations. This article explains what is required if you plan to install Easy8 on your own server and how to make the process easier with Docker or pre-built virtual machines.
Target Audience
- Administrator
Understanding Server Requirements
Two Ways to Avoid Manual Configuration
- Cloud – All infrastructure is managed by Easy Software. No setup required.
- Docker – For on-premise installations, Docker takes care of dependencies and streamlines upgrades.
Hardware Requirements
Minimum Setup (Up to 25 Users)
| Component | Specification |
|---|---|
| Processor | AMD Ryzen 7 PRO 7745 |
| Memory | 4 GB RAM |
| Disk Space | 50 GB (includes ~3 GB for database files) |
| Network | Required for connectivity |
Recommended for Larger Deployments
| Users | Threads/vCPU | RAM | HDD |
|---|---|---|---|
| 50 | 8 | 12 GB | 50 GB |
| 100 | 12 | 32 GB | 100 GB |
| 200 | 24 | 64 GB | 200 GB |
| 500 | 24 | 128 GB | 500 GB |
These values are recommendations. Final specifications depend on usage frequency and load.
Internet Connection Requirements
The server must have a minimum user-to-server connection speed of 10 Mbit. Performance may vary depending on:
- User's distance from the server
- Network route quality
- Server bandwidth capacity
Software Requirements
Docker (Recommended)
If you use Docker, you only need the Docker tools installed. All other requirements are pre-built into Docker images:
- Docker Engine: 27.3.1 (v14), 24.0.5 (v13), 20.10.22 (v12)
- Docker Compose: 2.29.7 (v14), 2.24.0 (v13), 2.15.1 (v12)
Legacy (Manual Installation)
If you install without Docker, the following are required:
| Component | v14 | v13 | v12 | v11 | v10 |
|---|---|---|---|---|---|
| OS | Debian 12 | Debian 11 | 10/11 | 10/11 | 10/11 |
| Architecture | amd64 | ||||
| Ruby | 3.3.7 | 3.1.2–3.1.4 | 3.1.2 | 2.7.x | 2.6.3 |
| Puma | 6.4.2 | 6.3.1 | 6.2.2 | – | – |
| NGINX | 1.20.x | – | – | ||
| Percona | 8.x | 8.x | 8.x | 5.7+ | 5.7+ |
| Redis | 7.x | 5.x | 5.x | 5.x | 5.x |
| Node.js | 20.16 | 18.17.1 | 18.8 | 14.16 | 14.16 |
| Bundler | 2.3.7+ | 2.3.7+ | 2.3.7+ | 2.2+ | 2.1.x |
| Rails | 6.x | 5.x | |||
| Xapian | 1.5.0 | – | |||
MariaDB and PostgreSQL are not supported in recent versions.
Client Requirements
Supported Web Browsers
- Google Chrome
- Mozilla Firefox
- Opera
- Safari
- Microsoft Edge
Note: Internet Explorer is not supported.
Supported Operating Systems
The two most recent versions of major operating systems are supported, including:
- Windows
- macOS
- Linux distributions
- Android
- iOS
Why We Recommend Docker
| Feature | Legacy | Docker |
|---|---|---|
| Dependency maintenance | Admin-managed | Easy Software-managed |
| Upgrade complexity | Multi-step | One-command |
| OS requirements | Specific (Debian) | Any with Docker (UNIX recommended) |
| Major version upgrades | Complex | As easy as a bug-fix update |
| Risk of untested dependencies | Possible | Eliminated (pre-built) |
⚠ Note: Docker on Windows WSL may have issues with data indexing.
Virtual Machine (VM) Option
We also provide OVA images for VMs on request. These come with Easy8 pre-installed and configured with supported components.
- Traditional VM = legacy installation
- New VM (v14+) = Docker-based
Conclusion
To run Easy8 successfully on your server, it's essential to meet specific hardware and software requirements. While legacy installations are still possible, Docker is the recommended method for modern, efficient, and low-maintenance deployment. For the easiest start, request a pre-built VM or use the official Docker image.
Related Topics and Further Reading
- Easy8 Documentation
- Docker Installation Guide
- How to Deploy Easy8 with Docker
- Easy8 Client Requirements
