This setup is the easiest to get started with. It will start a local database and the Langfuse server. The server is exposed on port
3000 by default.
It is not recommended to use this setup in production as the database is not persisted and environment variables are not secret. Checkout Langfuse Cloud for a production-ready setup maintained by the Langfuse team or alternatively self-host.
docker compose, both included in Docker Desktop (opens in a new tab)
# Clone repository git clone https://github.com/langfuse/langfuse.git cd langfuse # Run server and db docker compose up -d
# navigate to the Langfuse directory cd langfuse # Stop server and db docker compose down # Pull latest changes git pull docker-compose pull # Run server and db docker compose up -d
It will start a local database via Docker and the Langfuse server via NPM. The development server will watch for changes and restart automatically.
# Clone repository git clone https://github.com/langfuse/langfuse.git cd langfuse # Install dependencies npm install # Run the db in the background docker-compose -f docker-compose.dev.yml up -d # create an env file cp .env.dev.example .env # Apply database migrations npm run db:migrate # Optional: seed the database # npm run db:seed # npm run db:seed:examples # Start the development server npm run dev