Easier access to scientific data
Brought to you by NOAA NMFS SWFSC ERD    

Set Up Your Own ERDDAP™

Why? | Initial Setup | Update | Need To Know | Don't Need To Know |
Slide Shows | Programmer's Guide | List of Changes | Credits | License | Contact
And see the related document Working with the datasets.xml File

ERDDAP™ is a Free and Open Source (external link), all-Java (servlet), web application that runs in a web application server (for example, Tomcat (recommended), or Jetty (it works, but we don't support it)). This web page is mostly for people ("ERDDAP™ administrators") who want to set up their own ERDDAP™ installation at their own website.

Why use ERDDAP™ to distribute your data?

Because the small effort to set up ERDDAP™ brings many benefits. You can customize your ERDDAP's appearance so ERDDAP™ reflects your organization and fits in with the rest of your website.

ERDDAP™ has been installed by approximately 100 organizations in at least 17 countries

(Australia, Belgium, Canada, China, France, India, Ireland, Italy, New Zealand, Russia, South Africa, Spain, Sri Lanka, Sweden, Thailand, UK, USA), including: This is a list of just some of the organizations where ERDDAP™ has been installed by some individual or some group. It does not imply that the individual, the group, or the organization recommends or endorses ERDDAP.

ERDDAP™ is recommended within NOAA and CNRS
NOAA's Data Access Procedural Directive (external link) includes ERDDAP™ in its list of recommended data servers for use by groups within NOAA. ERDDAP™ is favorably mentioned in section 4.2.3 of the
Guide de bonnes pratiques sur la gestion des données de la recherche
(Research Data Management Best Practices Guide) (external link)
of the Centre National de la Recherche Scientifique (CNRS) in France.

Is the installation procedure hard? Can I do it?

The initial installation takes some time, but it isn't very hard. You can do it. If you get stuck, email me at erd dot data at noaa dot gov . I will help you.
Or, you can join the ERDDAP™ Google Group / Mailing List and post your question there.

How To Do the Initial Setup of ERDDAP™ on Your Server

Initial setup instructions have moved to their own page.

How To Do an Update of an Existing ERDDAP™ on Your Server

Update instructions have moved to their own page.

Things You Need To Know

Things You Don't Need To Know

These are details that you don't need to know until a need arises.

Slide Shows

Here are some PowerPoint slide shows and documents that Bob Simons has created related to ERDDAP.

DISCLAIMER: The content and opinions expressed in these documents are Bob Simons' personal opinions and do not necessarily reflect any position of the Government or the National Oceanic and Atmospheric Administration.

The Four Main Documents:

Other Presentations:

Presentations By Other People:


Programmer's Guide

The Programmer's Guide is now on a separate web page.

List of Changes

The List of Changes for each ERDDAP™ release is now on a separate web page.


The contributor credits for ERDDAP™ is now on a separate page. ERDDAP™ is a product of the NOAA (external link) NMFS (external link) SWFSC ERD.

Bob Simons is the original main author of ERDDAP™ (the designer and software developer who wrote the ERDDAP-specific code). The starting point was Roy Mendelssohn's (Bob's boss) suggestion that Bob turn his ConvertTable program (a small utility which converts tabular data from one format to another and which was largely code from Bob's pre-NOAA work that Bob re-licensed to be open source) into a web service.

It was and is Roy Mendelssohn's ideas about distributed data systems, his initial suggestion to Bob, and his ongoing support (including hardware, network, and other software support, and by freeing up Bob's time so he could spend more time on the ERDDAP™ code) that has made this project possible and enabled its growth.

The ERDDAP-specific code is licensed as copyrighted open source, with NOAA (external link) holding the copyright. See the ERDDAP™ license.
ERDDAP™ uses copyrighted open source, Apache, LGPL, MIT/X, Mozilla, and public domain libraries and data.
ERDDAP™ does not require any GPL code or commercial programs.

The bulk of the funding for work on ERDDAP™ has come from NOAA, in that it paid Bob Simons' salary. For the first year of ERDDAP™, when he was a government contractor, funding came from the NOAA CoastWatch (external link) program, the NOAA IOOS (external link) program, and the now defunct Pacific Ocean Shelf Tracking (POST) program.

Much credit goes to the many ERDDAP™ administrators and users who have made suggestions and comments which have led to many improvements in ERDDAP. Many are mentioned by name in the List of Changes. Thank you all (named and unnamed) very much. Thus, ERDDAP™ is a great example of User-Driven Innovation (external link), where product innovation often comes from consumers (ERDDAP™ users), not just the producers (ERDDAP™ developers).

Here is the list of software and datasets that are in the ERDDAP™ distribution. We are very grateful for all of these. Thank you very much.
[Starting in 2021, it has become almost impossible to properly list all of the sources of code for ERDDAP™ because a few of the libraries we use (notably netcdf-java and especially AWS) in turn use many, many other libraries. All of the libraries that ERDDAP™ code calls directly are included below, as are many of the libraries that the other libraries call in turn. If you see that we have omitted a project below, please let us know so we can add the project below and give credit where credit is due.]

We are also very grateful for all of the software and websites that we use when developing ERDDAP, including
Chrome (external link),
curl (external link),
DuckDuckGo (external link),
EditPlus (external link),
FileZilla (external link).
GitHub (external link),
Google Search (external link),
PuTTY (external link),
stack overflow (external link),
todoist (external link),
Wikipedia (external link),
the Internet, the World Wide Web, and all the other, great, helpful websites.
Thank you very much.


NOAA Software Public Domain Statement

As a work of the United States Government, this project is in the public domain within the United States. Software, as understood herein, shall be broadly interpreted as being inclusive of algorithms, source code, object code, databases and related documentation, all of which shall be furnished free of charge to the User.

Additionally, we waive copyright and related rights in the work worldwide through the CC0 1.0 Universal public domain dedication.

CC0 1.0 Universal Summary

This is a human-readable summary of the Legal Code (read the full text ).

No Copyright

The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law. The User can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.

Other Information

Use of the NOAA (National Oceanic and Atmospheric Administration) or NMFS and ERDDAP™ names and/or visual identifiers are protected under trademark law and may not be used without written permission from NOAA. Use of these names and/or visual identifiers to identify unaltered NOAA content or links to NOAA websites are allowable uses. Permission is not required to display unaltered NOAA products which include the NOAA, NMFS, or ERDDAP™ names and/or visual identifiers as part of the original product. Neither the names nor the visual identifiers may be used, however, in a manner that implies an endorsement or affiliation with NOAA.


Questions, comments, suggestions? Please send an email to erd dot data at noaa dot gov and include the ERDDAP™ URL directly related to your question or comment.

Or, you can join the ERDDAP™ Google Group / Mailing List by visiting!forum/erddap (external link) and clicking on "Apply for membership". Once you are a member, you can post your question there or search to see if the question has already been asked and answered.

ERDDAP, Version 2.24
Disclaimers | Privacy Policy