# Uploading a local tag database

{% hint style="warning" %}
If you are trying to upload a tag database to a SensorStation, or a V1 SensorGnome, refer to the [V1 SG guide](https://docs.motus.org/sensorgnome/maintenance/localtagdb).
{% endhint %}

## Introduction

If you are installing a station that detects Lotek tags, it is often useful to know whether it is able to detect tags in real time, particularly if you are deploying tags in the vicinity. Thankfully this is possible by loading a local tag database on to the internal storage of the device. When the SensorGnome boots up, it checks for a tag database and will display any of those tags it "hears" on its web interface.&#x20;

Viewing your live tag detections can also be useful when deploying tags or as a make-shift manual tracking device when a Lotek receiver is unavailable.

This works by using a local version of the tag finder algorithm ([`find_tags_unifile`](https://github.com/MotusWTS/find_tags)) in comparison with the tag recordings provided during registration.

{% hint style="danger" %}
There are some **very** important differences to be aware of between the tagfinder that runs on a SG and the one that runs on the Motus Server.&#x20;
{% endhint %}

The local tagfinder differs from the version found on Motus, in some key respects:

* It is only aware of the tags that you have provided, so its candidate list is minimal. It might therefore assign raw data to one of your tags even if a more suitable candidate exists in the Motus database
* It does not use deployment period or estimated battery life to assign data to candidate tags so it might "detect" a tag that has been dead for many years&#x20;
* It uses none of the [filters that are applied](https://docs.motus.org/en/about-motus/how-data-are-processed/public-data-filters) on the Motus website (and in the R data)&#x20;

All of this means that you will very often get different results on the local tagfinder as with data processed by the Motus server. Despite this, uploading a local tag database is recommended any time you are deploying tags.

### Steps

1. Navigate to your [project's tag management pages ](http://motus.org/data/project/tags) and click the "Download tag database" button

![](https://2642021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGrf8Wg5oUFTJbWHxHdF7%2Fuploads%2FoCt7DBztavHQ7ciok5ZL%2F2025-08-01_143706.png?alt=media\&token=3221db40-17fe-43aa-890d-3a7e97b5b0c9)

2\. Download the first option. This will contain all the tags currently registered to your project.

<figure><img src="https://2642021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGrf8Wg5oUFTJbWHxHdF7%2Fuploads%2FAwqPkFMH9uGSdIDdQF6Z%2F2025-08-01_144708.png?alt=media&#x26;token=d9f94a5d-08c3-45f8-b350-9cf256bff662" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The additional options seen above are an earlier, depcreated, format that was summarized by yearly quarter. These will only be visible for older projects, and will almost never be needed.
{% endhint %}

3. Connect to your SensorGnome via the WiFi hotspot and navigate to the "Radios" tab. Click "Upload new tag database" and select the `.sqlite` file you just downloaded. You should now see an updated summary including the new project and the number of tags you added.

{% hint style="warning" %}
You can add `.sqlite` files from multiple projects without needing to merge them into one.
{% endhint %}

<figure><img src="https://2642021313-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGrf8Wg5oUFTJbWHxHdF7%2Fuploads%2FBt3DBJwi6ZJ6d1xa8qfN%2F2025-08-01_145413.png?alt=media&#x26;token=52abce7b-777c-4c9f-914d-abf3d6aa1363" alt=""><figcaption></figcaption></figure>
