Access
- Open VitePress:
http://<SERVER_IP>
Edit & Publish Content
1. Add or edit Markdown files: /opt/vitepress/docs
2. If you add or rename pages, update /opt/vitepress/docs/.vitepress/config.mjs for navigation and sidebar entries.
3. Rebuild the site:
cd /opt/vitepress && npm run docs:build
Nginx serves the generated files from: /opt/vitepress/docs/.vitepress/dist
No Nginx restart is required after rebuilding.
Important Paths
- Project:
/opt/vitepress - Content:
/opt/vitepress/docs - Configuration:
/opt/vitepress/docs/.vitepress/config.mjs - Build output:
/opt/vitepress/docs/.vitepress/dist - Nginx configuration:
/etc/nginx/sites-available/vitepress.conf
Domain & HTTPS
1. Point your domain to the server's IP address.
2. Edit Nginx config and replace server_name _; with your domain (e.g., server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/vitepress.conf
3. Test the configuration:
nginx -t
4. Install Certbot:
apt install -y certbot python3-certbot-nginx
5. Generate a Let's Encrypt certificate:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Reload Nginx:
systemctl reload nginx
7. Open your browser and visit: https://<YOUR_DOMAIN>
