QexoVercel Deployment Guide

Deploy QexoVercel on Vercel

A step-by-step guide to deploy your Hexo blog management system

Step 1: Fork the Repository
Start by forking the QexoVercel repository to your GitHub account

Visit the QexoVercel GitHub repository and click the "Fork" button in the top-right corner.

Note: Make sure you're forking the correct repository. The official QexoVercel repository is maintained by am-abudu.

Fork Repository
Step 2: Configure Database
Set up a database to store your blog content and settings

QexoVercel supports several database options:

  • SQLite (not recommended for production on Vercel due to serverless limitations)
  • MySQL/MariaDB
  • PostgreSQL (recommended for Vercel deployment)

For Vercel deployment, we recommend using a PostgreSQL database from providers like:

  • Neon
  • Supabase
  • Railway

After setting up your database, make note of the connection string as you'll need it in the next steps.

Step 3: Deploy to Vercel
Connect your forked repository to Vercel for deployment
  1. Go to Vercel and sign in with your GitHub account
  2. Click "Add New" → "Project"
  3. Select your forked QexoVercel repository
  4. Configure the following environment variables in the Vercel project settings:
DATABASE_URL=your_database_connection_string
DJANGO_SUPERUSER_USERNAME=admin
DJANGO_SUPERUSER_PASSWORD=your_secure_password
DJANGO_SUPERUSER_EMAIL=your_email@example.com
SECRET_KEY=your_django_secret_key
ALLOWED_HOSTS=.vercel.app,your-custom-domain.com
DEBUG=False

Click "Deploy" and wait for the deployment to complete.

Deploy to Vercel
Step 4: Configure Your Blog Repository
Connect QexoVercel to your Hexo blog repository

After deployment, visit your Vercel app URL and log in with the superuser credentials you set in the environment variables.

Navigate to Settings and configure:

  • GitHub/GitLab/Gitee repository information
  • API tokens and access credentials
  • Hexo configuration settings
  • Custom deployment settings

Make sure your blog repository has the correct Hexo structure and configuration files.

Step 5: Test Your Deployment
Verify that everything is working correctly

Try creating a new post or editing an existing one through the QexoVercel interface.

Check that changes are being pushed to your repository and that your Hexo blog is being updated correctly.

If you encounter any issues, check the Vercel logs for error messages and ensure all environment variables are set correctly.