This repository provides a Docker Compose setup for Factry Historian, allowing you to quickly deploy a Historian server along with PostgreSQL, InfluxDB, and Grafana.

If you want to get started as quickly as possible, just run:

git clone https://github.com/factrylabs/historian
cd historian
docker compose up -d

✅ No environment variables needed
✅ Everything runs with default values
✅ Access the services:

• Factry Historian → http://localhost:8000 (Default login: factry / password)
• Grafana → http://localhost:3000 (Login: admin / admin)
• InfluxDB → http://localhost:8086
• PostgreSQL → localhost:5432 (User: factry, Password: password)

🚨 Important: This quick setup uses default passwords and should not be used for production. See the next section for customizing the setup.

Once the services are running, open Factry Historian at: 👉 http://localhost:8000

1. Login → Default username: factry, password: password (change immediately).
2. Activate a License (or start a trial).
3. Set Up an Organization → Choose a name & configure PostgreSQL access.
4. Connect to Internal Database → Use for this docker:
   • Host: http://influx:8086
   • Admin User: factry
   • Admin Password: password
5. Historian Configuration → Ensure correct API & authentication settings.
6. Finish Setup

1. Go to Configuration > Time Series Databases.
2. Create a database with:
   • Name: historian
   • Admin User: factry
   • Admin Password: password
   • Host: http://influx:8086
   • Database: historian
3. Click Save & Test.

1. Navigate to Collectors in Factry Historian.
2. Click Create Collector → e.g., OPC-UA Collector.
3. Click Generate Token and copy it.
4. Then proceed with the installation of your collector according to the README at https://github.com/factrylabs/collector.
5. Pass the copied token as API_TOKEN.
6. Run the collector with:

docker run -d --restart unless-stopped --name factry-collector -e API_TOKEN=<API_TOKEN> -e PRODUCT=opc-ua ghcr.io/factrylabs/collector:latest

In the advanced directory, you'll find a more customizable docker compose setup with environment variables for configuration and a cloud-init script to automate the setup in a cloud environment.

For help, visit: 📌 Factry Community https://www.reddit.com/r/Factry/