How to self-host your Datawrapper visualizations

If you want to be independent of our infrastructure, Datawrapper lets you self-host all your visualizations in your own Amazon S3 bucket, Google Cloud Storage bucket, or SFTP server. This is an option chosen by Datawrapper users who want to own their charts, maps & tables – be it because of company laws, data security, tracking options, or to manage downtime on your own. Hosting your own visualizations comes with more flexibility. If you're part of an organization that has experience with cloud hosting, this can be an excellent choice. 

To self-host your own visualizations, you'll need to be on an Enterprise plan.
You can find more information about our pricing options here.

To set up self-hosting, go to your account settings in Datawrapper and select your team. This will bring you to your team settings. Now click on Hosting to see the following options:Here you have the choice between our default Datawrapper content delivery network (CDN), Amazon S3 and Google Cloud Storage, and SFTP.

How to set up hosting on Amazon S3

After you selected Amazon S3, we'll need a few information from you to publish your visualization to the new destination: The S3 Bucket, Access Key, and Secret Key. You can also provide a path prefix, a region (e.g. 'us-east' or 'eu-central-1'), and override the settings for ACL and cache control.

In order to use your IAM access key with Datawrapper self-hosting, you need to give it at least the following permissions to your bucket:

  • HeadObject
  • PutObject 
  • PutObjectAcl 

Below that form, you get asked to enter the URL under which your visualizations will be accessible. Scroll down to "Define the URLs & save" to learn more.

How to set up hosting on Google Cloud Storage

If you select Google Cloud Storage, you'll get asked for the following information to smoothly set up your new visualization storage: Bucket name, Project ID, Client ID, Client E-Mail, Private Key ID, Private Key and the JSON key (as a file).

Below that form, you get asked to enter the URL under which your visualizations will be accessible. Scroll down to "Define the URLs & save" to learn more.

How to set up hosting via SFTP

After you selected SFTP, you'll need to define the host, port, and username, choose your authentification method and set a password or private key & passphrase. You can also define a path prefix:

Define the URLs & save

Datawrapper also needs to know   Once you entered all the information, we can upload your visualizations to your Amazon S3 or Google Cloud Storage buckets.the URL under which your visualizations will be accessible:

Alternative: Self-host using ZIP export

In case you don't want to use Amazon S3 or Google Cloud Storage or SFTP to host your visualizations, you can alternatively request a ZIP export of the visualization assets to host them in any other system that can serve static HTML content. To do so, create an API token and call the following API endpoint:

https://api.datawrapper.de/charts/:chartId:/export/zip

Datawrapper will return a ZIP file with all assets needed to host the chart. Embed the `index.html` or `embed.js` entrypoints contained within the ZIP file to include the embed in your CMS. You can generate an embed code as described in the responsive embed code documentation.

We're happy to help you with this setup and to answer any of your questions about self-hosting! Get in touch with us at support@datawrapper.de and we'll reply as soon as possible.