nullcart_promo_website/README.md at master

nobswebdev/nullcart_promo_website

Fork 0

Files

T

nobswebdev 169bbb8bad remove redundant step from setup

2026-09-10 13:29:21 +02:00

2.7 KiB

Raw Permalink Blame History

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

9. Updates

./deploy/scripts/update.sh

This pulls the latest code and rebuilds the stack (deploy.sh).

2.7 KiB Raw Permalink Blame History

NullCart Promo Website