This is the simplest and most effective solution for importing CSV files exported from Umami Cloud into your self-hosted Umami instance. While Umami Cloud offers a data export feature, the open-source self-hosted version lacks an import tool. This script and online tool provide a seamless way to migrate your data with ease.
For the fastest and easiest way to migrate data, I recommend using the online visual import tool. Simply upload the CSV file exported from Umami Cloud, and the system will automatically handle the data import—no coding required.
🤗Hugging Face Space Import Tool
I have created a video tutorial that demonstrates how to use this tool for migrating your data. Watch the video to quickly grasp the process:
For those who prefer written instructions, I also provide a detailed blog tutorial. It walks through the entire migration process and explains each step:
If you prefer to handle the migration manually on your local machine, we also offer a simple Python script to help you import data with full control over the process.
Choose from the following script options:
-
Jupyter Notebook version
umami_import.ipynb -
Python script
umami_import.py -
Pandas optimized version
umami_import_pandas.py