Quick Start

Get your first server connected to the LiteSoup dashboard in under 5 minutes.

1. Start the Dashboard

If you haven't already, deploy the dashboard on any machine with Docker:

git clone https://github.com/litesoup/litesoup-dashboard.git
cd litesoup-dashboard
docker compose up -d

Access http://YOUR_SERVER:3000 and log in with admin@example.com / admin123.

2. Connect a Server

Navigate to Servers in the sidebar and click Connect server. Fill in the form:

  • Display name — a label like "sg9" or "production-01"
  • Hostname — IP address or domain of your server
  • SSH user — usually root
  • SSH port — default 22
  • SSH key path — path to your private key on the dashboard host
  • Agent direct URL — optional, for direct agent communication

3. View the Dashboard

After connecting, the server appears in the servers list. Click on it to see:

  • CPU, RAM, and Disk metrics
  • Service status (Apache, MariaDB, Redis, PHP-FPM)
  • Sites table (auto-populated after sync)

4. Sync Sites

Click the Sync button on the server detail page. The dashboard scans the server's Apache vhosts and discovers existing WordPress sites. After sync completes, sites appear in the table.

Click Scan WP to detect WordPress versions, plugins, and themes for each site.

5. Create a Site

Click New site to create a WordPress site. Fill in the domain, select PHP version, pool tier, and TLS mode. The dashboard provisions the Apache vhost, PHP-FPM pool, and SSL certificate automatically.

Next Steps