getting-started

📥 Installation

Get EquosNine up and running on your system

📥 Installation

Get EquosNine installed and ready to transform your business operations in just a few simple steps.

🖥️ System Requirements

Before installing EquosNine, ensure your system meets these minimum requirements:

Desktop Application

  • Windows: Windows 10 or later (64-bit)
  • macOS: macOS 10.14 Mojave or later
  • Linux: Ubuntu 18.04, Debian 10, or equivalent
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 2GB available disk space
  • Network: Broadband internet connection

Web Application

  • Modern web browser: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
  • JavaScript enabled
  • Stable internet connection

🚀 Installation Options

Choose the installation method that works best for your setup:

Windows Installation

  1. Download the installer from equosnine.com/download
  2. Run EquosNine-Setup.exe as Administrator
  3. Follow the installation wizard:
    • Accept the license agreement
    • Choose installation directory
    • Select additional components
  4. Launch EquosNine from the Start Menu or desktop shortcut
# Silent installation (for IT administrators)
EquosNine-Setup.exe /S /D=C:\Program Files\EquosNine

macOS Installation

  1. Download the .dmg file from our website
  2. Open the disk image file
  3. Drag EquosNine to your Applications folder
  4. Launch from Launchpad or Applications folder
  5. Allow the app if prompted by macOS security
# Command line installation via Homebrew
brew install --cask equosnine

Linux Installation

Ubuntu/Debian:

# Download and install the .deb package
wget https://releases.equosnine.com/linux/equosnine-latest.deb
sudo dpkg -i equosnine-latest.deb
sudo apt-get install -f  # Fix dependencies if needed

Red Hat/CentOS/Fedora:

# Download and install the .rpm package
wget https://releases.equosnine.com/linux/equosnine-latest.rpm
sudo rpm -i equosnine-latest.rpm

Universal Linux (AppImage):

# Download and run the AppImage
wget https://releases.equosnine.com/linux/EquosNine-latest.AppImage
chmod +x EquosNine-latest.AppImage
./EquosNine-latest.AppImage

Option 2: Web Application

Access EquosNine directly through your web browser:

  1. Visit app.equosnine.com
  2. Create your account or sign in
  3. Complete the setup wizard
  4. Start managing your business!

Option 3: Self-Hosted (Enterprise)

For organizations requiring on-premise deployment:

# Docker deployment
docker pull equosnine/server:latest
docker run -d -p 8080:8080 --name equosnine equosnine/server:latest

# Docker Compose (recommended)
wget https://raw.githubusercontent.com/equosnine/docker/main/docker-compose.yml
docker-compose up -d

⚙️ Initial Setup

After installation, complete the initial setup:

1. Account Creation

  • Personal account: For individual users
  • Business account: For teams and organizations
  • Enterprise account: For large organizations with advanced needs

2. Business Information

Configure your business details:

  • Company name and logo
  • Business address and contact information
  • Tax identification numbers
  • Preferred currency and locale

3. User Preferences

Set up your workspace:

  • Interface theme (light/dark)
  • Notification preferences
  • Default templates
  • Language and timezone

🔧 Configuration

Database Setup (Self-Hosted Only)

EquosNine supports multiple database backends:

PostgreSQL (Recommended):

-- Create database and user
CREATE DATABASE equosnine;
CREATE USER equosnine_user WITH PASSWORD 'secure_password';
GRANT ALL PRIVILEGES ON DATABASE equosnine TO equosnine_user;

MySQL:

-- Create database and user
CREATE DATABASE equosnine;
CREATE USER 'equosnine_user'@'localhost' IDENTIFIED BY 'secure_password';
GRANT ALL PRIVILEGES ON equosnine.* TO 'equosnine_user'@'localhost';
FLUSH PRIVILEGES;

Environment Configuration

Create a configuration file:

# config.yml
database:
  type: postgresql
  host: localhost
  port: 5432
  database: equosnine
  username: equosnine_user
  password: secure_password

server:
  host: 0.0.0.0
  port: 8080
  ssl: true

security:
  jwt_secret: your-secret-key
  session_timeout: 3600

✅ Verification

Verify your installation is working correctly:

Desktop Application

  1. Launch EquosNine
  2. Check the version in Help → About
  3. Test database connection
  4. Create a test invoice

Web Application

  1. Access your EquosNine dashboard
  2. Navigate through the main features
  3. Check all modules load correctly

Command Line Verification

# Check version
equosnine --version

# Run system diagnostics
equosnine doctor

# Test database connection
equosnine db:ping

🔄 Updates

Keep EquosNine up to date:

Automatic Updates (Desktop)

  • Updates download automatically
  • Restart when prompted
  • Backup created before each update

Manual Updates (Self-Hosted)

# Docker update
docker pull equosnine/server:latest
docker-compose up -d

# System package update
sudo apt update && sudo apt upgrade equosnine  # Ubuntu/Debian
sudo dnf update equosnine  # Fedora

🆘 Troubleshooting

Common Installation Issues

Windows: “Installation failed” error

  • Run installer as Administrator
  • Disable antivirus temporarily
  • Check available disk space

macOS: “App can’t be opened” error

  • Go to System Preferences → Security & Privacy
  • Click “Open Anyway” for EquosNine

Linux: Missing dependencies

# Ubuntu/Debian
sudo apt-get install -f

# Install missing libraries
sudo apt-get install libgtk-3-0 libx11-xcb1

Database connection issues

  • Verify database server is running
  • Check connection credentials
  • Ensure firewall allows database port

Getting Help

If you encounter issues:

Next Steps: Once installation is complete, proceed to Initial Setup to configure your business settings.

← Back to Documentation
Edit this page