# Letopis

Letopis is a self-hosted idle civilization simulation, available in English and Bulgarian, where families start in the Stone Age and gradually discover fire, tools, and farming so you can check its web page anytime to. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7554/letopis

## Description

Letopis is a self-hosted idle civilization simulation, available in English and Bulgarian, where families start in the Stone Age and gradually discover fire, tools, and farming so you can check its web page anytime to see how the world has developed.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 17 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_6012ef327d07a5f1
- GitHub: https://github.com/leppermesiah/letopis
- Documentation: https://letopis.tech/docs/getting-started/

## Common questions

### Which port should I expose for Letopis?

Expose port 2222 by default. You can change the listening port with the LETOPIS_PORT environment variable.

### Where is the game state stored, and how often is it saved?

The world, SQLite chronicle, and archive live in the LETOPIS_DATA directory, defaulting to /data. It saves every 2 minutes and when the container stops.

### What happens if the civilization dies out?

The finished world is archived in /data/archive/, and Letopis starts a new world one minute later.

### Can I control the initial world generation?

Set LETOPIS_SEED to choose the seed for the first world. By default a random seed is used.

### Can I accelerate the simulation for testing?

LETOPIS_SPEED sets a time multiplier, but it is only for testing. The default speed is 1.

---
Source: Our Local Host (https://ourlocalhost.com/app/7554/letopis), the self-hosted and open-source app directory.
