Deploy Guide

Steps to update the live site on the SFTP server.

1. Make your changes

Edit posts, pages, data files, styles, etc. as needed.

2. Test locally

Make sure the Jekyll container is running:

docker ps | grep quads-site

If it’s not running, start it:

docker start quads-site

Open http://localhost:4000 in your browser. The container auto-regenerates on file changes, so just refresh after edits.

Click through:

• Home page
• Each post / news item you changed
• About, blog index, tags, categories
• Anything that touches your changes

3. Build a clean production copy

docker exec quads-site bundle exec jekyll clean
docker exec quads-site bundle exec jekyll build

Verify _site/ looks right:

ls _site/

Expected: 404.html, about, assets, blog, categories, feed.xml, index.html, page2, posts, robots.txt, sitemap.xml, tags.

4. Strip non-site files from the build

rm -f _site/Dockerfile _site/README.md

(These get copied in because _config.yml doesn’t exclude them. Safe to remove from the upload.)

5. Connect to the SFTP server

sftp USER@HOST

You should land in the web root (where index.html, assets/, etc. live).

6. Upload

In the sftp> prompt:

lcd /Users/epap/Projects/sites/quads-site/_site
put -r *

Wait for it to finish — every file scrolls by as it uploads.

7. Verify and disconnect

ls
bye

Then open the live site in a browser and click through the same pages you tested in step 2.

Notes

• put -r * overwrites files on the server that have the same name and leaves everything else alone. The remote extras (awstats-icon/, awstatsicons/, icon/, index_old.html, page2/, README.md) stay in place.
• Every upload re-transfers every file. For faster incremental syncs later, switch to lftp mirror -R --only-newer.