Skip to content

mirrors: cleanup of mirrors #515

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
May 15, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 50 additions & 38 deletions content/about/mirrors.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,69 @@
---
title: "GRASS GIS Website mirrors"
date: 2022-05-28T10:12:05+02:00
title: " GRASS Website mirrors"
date: 2025-05-14T10:12:05+02:00
layout: "general"
---

### Official main site via HTTP/FTP
# GRASS Website mirrors

* [Official main site: grass.osgeo.org](https://grass.osgeo.org/) (Portland, USA)
## Official main site

### African Web site mirrors
- [Official main site: grass.osgeo.org](https://grass.osgeo.org/) (Portland, USA)

* [South Africa](https://grass.mirror.ac.za/) (Tier 1,TENET)
* [Morocco](https://grass.marwan.ma/) (Moroccan National Research and Education Network, MARWAN)
## Mirror sites

### Asian-Indian Web site mirrors
- [Morocco](https://grass.marwan.ma/) (Moroccan National Research and Education Network, MARWAN)
- [South Africa](https://grass.mirror.ac.za/) (TENET)
- [Italy](https://grass.mirror.download.it) (Download.it)
- [USA](https://mirrors.ibiblio.org/grass/html/) (ibiblio)

* [India](http://wgbis.ces.iisc.ernet.in/grass/) (Tier 2, Indian Institute of Science, Bangalore)
<!-- * [Japan](http://wgrass.media.osaka-cu.ac.jp/grassh/) (Tier 2, Osaka City University) -->
<!-- * [South Korea](http://pinus.gntech.ac.kr/grass/) (Tier 2, Gyung-Nam National University of Science &amp; Technology) -->
## Mirror our website

### European Web site mirrors

* [Italy](http://grass.mirror.download.it) (Tier 1)
<!-- * [Czech Republic](http://grass.fsv.cvut.cz) (Tier 2, Czech Technical University in Prague, Department of Geomatics) -->

### Mirror our website
If you would like to support the GRASS community, do not hesitate to set up your mirror site.
Please consider to [contact us](mailto:grass-web(at)lists.osgeo.org), ideally reporting your [already running mirror](/about/mirrors/).
Please consider to [contact us](/support/), ideally reporting your [already running mirror](/about/mirrors/).

### Requirements

#### Requirements:
A GRASS mirror site requires around 23 GB space, the space requirements may vary due to the changing presence of precompiled binaries.

#### How to set up a mirror site:
### How to set up a mirror site

The main site hosted at OSGeo (grass.osgeo.org) can be mirrored with the ["rsync"](http://rsync.samba.org/) software protocol, allowing to synchronize mirrors automatically overnight. The idea of using the "rsync" mirror software is that only changed files are transferred after the initial synchronization which minimizes the network traffic.
The main site hosted at OSGeo (grass.osgeo.org) can be mirrored with the ["rsync"](https://rsync.samba.org/) software protocol, allowing to synchronize mirrors automatically overnight. The idea of using the "rsync" mirror software is that only changed files are transferred after the initial synchronization which minimizes the network traffic.

#### Mirror site setup in greater detail:
#### Mirror site setup in greater detail

* Install the rsync software.
* Check if you can connect - note the two '::' characters:
* `rsync -az --port=50026 grass.osgeo.org::`
* This command should display the following welcome message:
- Install the `rsync` software.
- Check if you can connect - note the two `::` characters:

```
rsync -az --port=50026 grass.osgeo.org::
```
GRASS GIS Website
grass-website GRASS GIS Website

- This command should display the following welcome message:

```
GRASS Website
grass-website GRASS Website
```

- Now generate a mirror folder on your server where to store the GRASS website copy. We assume `/var/www/html/mirror/`:

```
* Now generate a mirror folder on your server where to store the GRASS GIS website copy. We assume `/var/www/html/mirror/`:
* `mkdir /var/www/html/mirror/`
* Change into this folder and copy the website into the subfolder `grass-website`:
* `cd /var/www/html/mirror/`
* `rsync -az --port=50026 grass.osgeo.org::grass-website grass-website`
* Once finished, define a daily cron-job (in 'crontab') for rsync (example):
* `/usr/bin/rsync -az --port=50026 grass.osgeo.org::grass-website /var/www/html/mirror/grass-website`
* This will copy/update the GRASS site to your local directory /var/www/html/mirror/grass-website/ which needs to be made available in your web server.
* Check if the synchronization works the next day(s).
* Announce the new mirror site for this mirror list to [us](mailto:grass-web(at)lists.osgeo.org).
mkdir /var/www/html/mirror/
```

- Change into this folder and copy the website into the subfolder `grass-website`:

```
cd /var/www/html/mirror/
rsync -az --port=50026 grass.osgeo.org::grass-website grass-website
```

- Once finished, define a daily cron-job (in 'crontab') for rsync (example). This will copy/update the GRASS site to your local directory /var/www/html/mirror/grass-website/ which needs to be made available in your web server.

```
/usr/bin/rsync -az --port=50026 grass.osgeo.org::grass-website /var/www/html/mirror/grass-website
```

- Check if the synchronization works the next day(s).
- Tell [us](/support/) about your new mirror site.