Hosting a Mirror

Hosting a mirror is simple. You need rsync, some disk space, bandwidth, and a hostname. JSAN currently must run under a hostname such as "subdomain.example.com". Directory Indexes should be turned on for the "dist/" location. Please do not sync more than once every hour. And realistically you only need to sync once or twice a day.

To mirror JSAN run the following rsync command from cron. Change "/usr/local/jsan" to your document root for the JSAN mirror host.

rsync -avz --delete rsync://master.openjsan.org/jsan /usr/local/jsan

If you want to use your own logo at the bottom of the page, save it to /usr/local/jsan/images/mirror/logo.png and rsync with this instead:

rsync -avz --delete --exclude=/images/mirror/logo.png \
    rsync://master.openjsan.org/jsan /usr/local/jsan

If you want to use your own logo at the bottom of the page, and you want the ability to link to it, or make some other reasonable modification, you can create a JavaScript file that will write your logo and associated HTML inline. Re-write /usr/local/jsan/js/script/mirror.js and rsync with this instead:

rsync -avz --delete --exclude=/js/script/mirror.js \
    rsync://master.openjsan.org/jsan /usr/local/jsan

Next, send email to the JSAN Development list and tell us what the host is, who you are, and what country your mirror is in. If your world region is not represented in the list then we need you!

Master Sites

Asia

Europe

Middle East

North America