Historian is a Firefox extension that periodically sends your browsing history to a remote database for long term storage. Currently QuestDB is the only database supported.
- Install Historian
- Create the required database tables by running the SQL in
ddl.sqlin your QuestDB instance. - Go the addon preferences:
- Set the database host to be the import URL of your QuestDB instance. This is usually just the URL of your QuestDB instance with
/impadded to the end. - Choose a machine ID. Historian associates each history entry with the machine ID which is helpful if you run multiple instances of Historian.
- Choose a profile ID. Historian associates each history entry with the profile ID which is helpful if you run multiple instances of Historian.
- Set the database host to be the import URL of your QuestDB instance. This is usually just the URL of your QuestDB instance with
- Historian will only send history entries created after it is installed. Historian will also wait until a history entry is 30 mins old before sending it (technical limitation). Therefore you should not expect entries to show up in the database right away.
If you have Firefox sync enabled you must only install Historian on a single device. Historian will archive both the history on device it is installed on as well as the history on all synced devices. Multiple installations of Historian will result in duplicate data being sent to the database, therefore it is highly discouraged! Note that Historian will report all history entries as coming from the machine Historian is installed on. This is because Historian cannot determine which history entries were produced by which synced device.