Trailkeepr

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #go #golang #android #java #vue #security #ios #openai #open-source

(★ 19)

A self-hosted solution for storing your favourite hiking and climbing spots.

Trailkeepr Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<br>

A self-hosted app to archive your outdoor adventures — hikes, climbs, scrambles, and everything in between. Import your GPX tracks, attach photos, write notes, and browse everything on an interactive map. Your data lives on your own machine.

## Features

- Import and view GPX tracks
- Create points of interest and areas
- Add descriptions, photos and metadata to each entry
- Use filtering options
- Find places with the search bar
- Responsive interface — works on desktop and mobile

## Installation

The only prerequisite is [Docker](https://docs.docker.com/get-started/get-docker/). No API key or external account required.

### Stable release (recommended)

Download the latest release source archive from the latest release page:

https://github.com/TheoFABIEN/Trailkeepr/releases/latest

Extract it, open a terminal in the extracted folder and start the app by running:

```bash
docker compose up -d
```

Then open [http://localhost:3000](http://localhost:3000) in your browser. That's it.

### Latest version

To get the latest changes, clone the repository directly:

```bash
git clone https://github.com/TheoFABIEN/Trailkeepr.git
cd Trailkeepr
docker compose up -d
```

## Configuration (optional)

### Database credentials

By default, the app uses the following credentials to connect to the database:

| Variable            | Default    |
| ------------------- | ---------- |
| `POSTGRES_USER`     | `postgres` |
| `POSTGRES_PASSWORD` | `changeme` |
| `POSTGRES_DB`       | `hiking`   |

These defaults work out of the box — no configuration needed for a standard local setup.

If you really want to use your own credentials, create a `.env` file from the provided `.env.example` before starting the app for the first time:

```bash
cp .env.example .env
```

Then edit .env with your own values.

> ⚠️ **Credentials must be set before the first `docker compose up -d`.** The database is initialized once on first launch. If you change credentials in `.env` after the database has already been created, the app will fail to connect. To reset, you will need to delete the existing data volume and recreate it:
>
> ```bash
> docker compose down -v
> rm -rf ./data
> docker compose up -d
> ```
>
> <ins>**This will permanently delete all your archived hikes, points, and photos.**</ins> Make sure to back up anything important before doing this.

## Contributing

Any help or suggestion is welcome ! I’d be happy to hear new ideas or walk you through the project structure if you’d like to contribute.

Trailkeepr

Trailkeepr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Trailkeepr

Trailkeepr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README