Ksable's Nest
HomeGuestbookFriendsAbout

Posts: Migrate Umami Cloud data into self-hosted Umami

Published 2024-08-28 16:25 Updated 2024-08-28 16:25 320 words 2 min read

kissablecho avatar

kissablecho

Kissablecho's personal blog — recording life, sharing technology, anime & white stockings enthusiast.

146 Articles

4 Categories

8 Tags
Home Guestbook
Categories Tags Archives
Friends About
Tools Music Bangumi Changelog
Wallpaper Engine Wallpaper Recommendations - Anime Random WallpapersPosts: Get visitor data via Umami APIPosts: N pigs by a netizenPosts: How to Set the Default Program to Open Files on Windows Using PythonPosts: Developed a 'note management platform'Posts: H Manga Website Crawler Practical ImplementationPosts: Python Web Crawler General Novel DownloaderPosts: A tutorial on scraping the CSDN website and saving as a local Markdown file (Python)Posts: Hexo Theme Development NotesPosts: Migrate Umami Cloud data into self-hosted UmamiPosts: Using Decap CMS as Hexo Backend for Online Editing (Comprehensive Tutorial)Posts: Simple Usage of ArtPlayer PlayerPosts: Beautiful 2D Image SharingPosts: 转载，为什么我们总是在等别人主动？Posts: Hexo Volantis theme subtitle output with a typing effect HitokotoTypewriter Effect Hitokoto (html+css+js)Batch Download Songs from NetEase Cloud Music Playlist (Python)Posts: Hexo Volantis theme music player Aplayer adapts to dark mode and can follow changes.Posts: This site's wallpaper
Umami's data import/export seems to be available only on Umami Cloud, while self-hosted versions do not have this option. We hope the Umami development team can add the import/export functionality. This article guides you on how to export data from Umami Cloud and migrate it to a self-hosted Umami.

Translated by AI model Qwen/Qwen3-8B.

Source Language: Simplified Chinese, Target Language: english, Translation Time: 2026-05-01 14:57

.

AI translation is for reference only. Accuracy is not guaranteed, please refer to the original text.

Preface

Umami Cloud has two obvious limitations

  1. The free version only retains 1 year of data
  2. Only 3 websites can be added

1 year of data retention is definitely not enough, I want to record for several years.

It seems that data import/export functionality is only available in Umami Cloud, while self-hosted versions lack this option. I hope the Umami development team can add import/export functionality.

This article guides you through exporting data from Umami Cloud and migrating it to self-hosted Umami.

Much of the content in this article references 《How to Import a CSV from Umami Cloud to Self-Hosted Umami》

Exporting Umami Cloud Data

In the left sidebar of Umami Cloud, open Data, click the Export button, select the website you want to export, and click export to receive a download link in your email. Note that the download link may require some magic to open.

导出 Umami Cloud 数据
导出 Umami Cloud 数据

Data Processing

You need to use a Python script to process the data, which can be downloaded from GitHub script or used via Huggingface Space.

Follow the instructions in the script or website, replacing the old site ID with the new site ID.

GitHub uses umami_import_pandas.py or umami_import.py to process data

After processing the data, you will see two generated files: website_event.csv and session.csv.

Then use the code at the bottom of the umami_import_no_duplicates.ipynb file to remove duplicate values from session.csv

Finish

Finally, open your Umami and you will see that the imported data is correctly displayed.

  1. 《How to Import a CSV from Umami Cloud to Self-Hosted Umami》
  2. https://github.com/umami-software/umami/issues/2653#issuecomment-2040970801
  3. https://github.com/umami-software/umami/issues/2456
  4. RoversX/umami-csv-import-script
  5. Huggingface Space | Umami Data Processing

If you enjoyed this, leave a comment~