Setup for the whole seosnap stack including dashboard, cache server and cache warmer used for prerendering and full page caching PWA's.
- Download and Extract release.zip from
./install.shor create a .env file manually
- Start the Seosnap stack with
# Clone cd ~ git clone --recursive firstname.lastname@example.org:experius/SeoSnap.git seosnap # Configure make install # Start server make up
- Dashboard: http://127.0.0.1:8080/ (default login: snaptron/Sn@ptron1337)
- API Docs: http://127.0.0.1:8080/docs
- Rendertron Server: http://127.0.0.1:3000/render/\<your url>
Logs directory ./logs
Cache directory ./cache
Run cache warmer
Make sure you have created a website via dashboard http://127.0.0.1:8080/seosnap/website/add/
make cachewarmer make warm A="cache <website id>"
Check the nginx.conf in the example folder
check the crontab.txt the example folder and use the cachewarmer.sh & healthchecks.sh
- cachewarmer - create your own cachewarmer.sh and update the healthchecks url and the website ids
- healthchecks - Just replace the https://hc-ping.com/xxxx with your ping URL & change https://galaxy.experius.nl/ to your PWA homepage
- backups - there is an example cron which will make a backup of the cache files
- docker volumes cleanup - as you can see in the cachewarmer.sh the rendertron container will be restarted for performance so we need to clean that up
How it works
In the dashboard you add the website url along with the website sitemap that you want to make 'SeoSnaps' off.
When the crawler is started it connects with the dashboard api. It uses scrapy to crawl the sitemap. The scrapy results are send to the administration/dashboard. Scrapy requests are send to the cache server. In a similar way that you would do a request to rendertron.
The cache server is a simple file caching server. If a file exist with the content of the page it serves the html from the file. If not, it renders the requested url with rendertron and saves the html output in a file. To refresh the cache the cache-warmer uses PUT requests instead of GET. This will force update from the cache file.
Rendertron + Cache is added and will replace the SeoSnap Cache Server
Recommended Rendertron config has been set in rendertron-config.json