vGocms Core Detailed Installation Guide

System Requirements

VPS/Server running Ubuntu 20.04 or 22.04.
aaPanel installed.
Software on aaPanel: Nginx, MariaDB, Redis, and Supervisor Manager.
Latest MariaDB version is recommended over MySQL.

Step 1: Download Source Code & Permissions

Access Files in aaPanel. Create the root directory:

/www/wwwroot/vgocms.com

Download and extract the latest build via the link below: Download Zip.

Grant execute permission 755 to vgocms_linux_amd64:

aaPanel UI: Right-click the file -> Permission. Check Execute. Set Owner to www. Apply.
Terminal/SSH:

chmod +x /www/wwwroot/vgocms.com/vgocms_linux_amd64

Step 2: Install Node.js (Required for Theme)

Node.js is required to compile frontend resources. Install Node.js version manager from the App Store.

Install a Stable Version, v20 or higher. Set it as default in Command line version.

Step 3: Initialize MariaDB Database & Check Redis

For optimal vGocms performance, use the latest version of MariaDB instead of MySQL. You can run MariaDB and MySQL in parallel on the same server if needed.

Go to Databases -> Add database.

Security note: Do not use the root account or simple passwords. Create a specific database and user with a strong password.

Example:

DB Name: vgocms_db or your choice.
User: vgocms_user.
Password: use a strong auto-generated password.

Check that Redis runs on port 6379. Note the password if any.

Step 4: Environment Variables (.env)

Edit the .env file. The values provided in the template, such as root or 123456, are examples only. Replace them with the actual credentials created in Step 3.

Important:

SESSION_SECRET: Must be changed to a long random string.
APP_PORT: Internal port, default is 8000.

# --- Database (TEMPLATE ONLY - DO NOT USE root/123456 in production) ---
DB_HOST=localhost
DB_PORT=3306
DB_USER=your_secure_db_user
DB_PASS=your_secure_password
DB_NAME=your_db_name

# --- Redis ---
REDIS_ADDR=localhost:6379
REDIS_PASS=
REDIS_DB=0

# --- User Microservice Integration ---
USER_SERVICE_BASE_URL=http://localhost:8081
USER_SERVICE_WEBHOOK_ENABLED=1
USER_SERVICE_WEBHOOK_SECRET=123456

# --- Session ---
SESSION_SECRET=change_this_to_a_very_long_random_string_in_production

# --- Application ---
APP_PORT=8000
GIN_MODE=release

Step 5: Run Service via Supervisor Manager

Open Supervisor Manager -> Add Daemon.

Name: vgocms_core
Run User: www
Run Directory: /www/wwwroot/vgocms.com
Start Command: /www/wwwroot/vgocms.com/vgocms_linux_amd64

Step 6: Configure Reverse Proxy (Nginx)

Add a website on aaPanel. Go to Reverse proxy -> Add reverse proxy.

Target URL:

http://localhost:8000

Install Let's Encrypt SSL.

Step 7: Admin Login & Security

After installation, access the admin panel at:

http://yourdomain.com/admin/login

Default Account: [email protected]

Password: admin123

Security Recommendation: Change the admin email and password immediately after the first login. You can also change the /admin URL path in the settings to protect against brute-force attacks.

Detailed Installation Guide for vGocms Core on Ubuntu VPS