KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

Trailkeepr

★ 19 Open GitHub ↗

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

// 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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README