Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fixup fr24 signup instructions #136

Merged
merged 1 commit into from
Mar 3, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 18 additions & 32 deletions feeder-containers/feeding-flightradar24.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,53 +22,39 @@ To get your _fr24key_, log onto your feeder and issue the command:
cat /etc/fr24feed.ini | grep fr24key
```

You can also find it in the datasharing section on the fr24 website if you have an account with the email address that was used when creating the key.

### New to `fr24feed`?

If you're already feeding FlightRadar24 and you've followed the steps in the previous command, you can skip this section.

First-time users should obtain a FlightRadar24 sharing key \(a _fr24key_\). To get one, you can run through the sign-up process. This will ask a series of questions allowing you to sign up with FlightRadar24 and get a _fr24key_.
Use the same email address as for your fr24 account if you already have one or plan on creating one.

There's an automated script that you can run, however if this breaks please let us know by raising an issue on [GitHub](https://github.com/sdr-enthusiasts/docker-flightradar24/issues). You can also use the manual sign-up method.

#### Automatic Sign-Up Script Method

Run these commands from within your application directory \(`/opt/adsb`\):

```text
source ./.env
docker run \
--rm \
-it \
-e FEEDER_LAT="$FEEDER_LAT" \
-e FEEDER_LONG="$FEEDER_LONG" \
-e FEEDER_ALT_FT="$FEEDER_ALT_FT" \
-e FR24_EMAIL="[email protected]" \
--entrypoint /scripts/signup.sh \
ghcr.io/sdr-enthusiasts/docker-flightradar24
```

Be sure to replace `[email protected]` with your actual email address!
#### Manual Sign-Up Method

After about 30 seconds or so, if the script method was successful, you should see output similar to this:
Run the command:

```text
FR24_SHARING_KEY=5fa9ca2g9049b615
FR24_RADAR_ID=T-XXXX123
docker run -it --rm ghcr.io/sdr-enthusiasts/docker-baseimage:qemu bash -c "$(curl -sSL https://raw.githubusercontent.com/sdr-enthusiasts/docker-flightradar24/main/get_adsb_key.sh)"
```

Simply copy these lines and paste them into your `.env` file.

If something went wrong, please take a moment to let me know, then try the manual method below.
This will start up a container. After installing a bunch of software (which may take a while depending on the speed of your machine and internet connection), it will take you through the signup process. Most of the answers don't matter as during normal operation the configuration will be set with environment variables. I would suggest answering as follows:

#### Manual Sign-Up Method
- `Step 1.1 - Enter your email address ([email protected])`: Enter your FlightRadar24 account email address
- `Step 1.2 - If you used to feed FR24 with ADS-B data before, enter your sharing key.`: Leave blank and press enter
- `Step 1.3 - Would you like to participate in MLAT calculations?`: Answer `no`
- `Would you like to continue using these settings?`: Answer `yes`
- `Step 4.1 - Receiver selection (in order to run MLAT please use DVB-T stick with dump1090 utility bundled with fr24feed)... Enter your receiver type (1-7)`: Answer `4`.
- `Enter your connection type`: Answer `1`.
- `host`: Answer: 127.0.0.1
- `port`: Answer: 30005
- `Step 5`: Answer: 2x `no`

Run the command:

```text
docker run --rm -it --entrypoint fr24feed ghcr.io/sdr-enthusiasts/docker-flightradar24 --signup
```
Note that there is a limit of 3 feeders per FR24 account. ADSB and UAT (see below) both count as 1 feeder. If you have more than 3 feeders, you will need to contact <[email protected]> to request an additional Feeder Key. Make sure to send them your account email-address, latitude, longitude, altitude, and if the key is for an ADSB or UAT feeder.

This will take you through the sign-up process. At the end of the sign-up process, you'll be presented with:
At the end of the sign-up process, you'll be presented with:

```text
Congratulations! You are now registered and ready to share ADS-B data with Flightradar24.
Expand Down
Loading