nobswebdev
d7733afdad
Add copy-paste deploy steps matching the NullCart guide, including TLS bootstrap, Let's Encrypt, Tor onion, and updates.
2.8 KiB
NullCart Promo Website
Static promo landing page for NullCart - HTML and CSS only, zero JavaScript.
Development
No Docker required locally. Open index.html in your browser.
Production
1. Requirements
- Ubuntu 22.04+ or similar Linux with Docker Engine and the Compose plugin — follow Install Docker Engine on Ubuntu
- A domain name pointing at your server (A records for apex and
www)
2. Server setup
Deploy as root on the VPS.
Verify:
docker compose version
3. Clone the repository
cd /root
git clone https://git.nobswebdev.com/nobswebdev/nullcart_promo_website.git nullcart_promo_website
cd nullcart_promo_website
4. Configure environment
cd /root/nullcart_promo_website
cp .env.example .env.prod
chmod 600 .env.prod
Edit .env.prod:
| Variable | Production value |
|---|---|
COMPOSE_PROJECT_NAME |
nullcart_promo_prod |
CLEARNET_DOMAIN |
apex only, e.g. nullcart.net |
5. Bootstrap TLS certificates
Nginx needs certificate files before it can start on port 443. For the first deploy, create a temporary self-signed pair (replaced after Let's Encrypt):
./deploy/scripts/bootstrap-certs.sh
After the stack is running, obtain real certificates (step 7).
6. Start the stack
./deploy/scripts/deploy.sh
Check containers:
docker compose --env-file .env.prod -f docker-compose.prod.yml ps
7. Issue Let's Encrypt certificates
Remove the temporary bootstrap certificates under deploy/certs/live/ (Certbot cannot issue into the layout created by bootstrap-certs.sh):
rm -rf deploy/certs/live/*
Request the real certificate (apex + www):
./deploy/scripts/issue-certs.sh --email you@example.com
Reload nginx:
docker compose --env-file .env.prod -f docker-compose.prod.yml exec nginx nginx -s reload
Automatic renewal
Open root's crontab:
crontab -e
Add a weekly job (/root/nullcart_promo_website is the standard deploy path):
0 3 * * 0 /root/nullcart_promo_website/deploy/scripts/renew-certs.sh >> /var/log/nullcart-promo-cert-renew.log 2>&1
Save and exit the editor. Optional — run once manually to verify:
/root/nullcart_promo_website/deploy/scripts/renew-certs.sh
8. Tor onion address
./deploy/scripts/show-onion.sh
Update onion links in index.html if needed, then redeploy:
./deploy/scripts/deploy.sh
9. Updates
./deploy/scripts/update.sh
This pulls the latest code and rebuilds the stack (deploy.sh).