Overview
Ideon replaces abstract folders with spatial organization. Instead of navigating tabs, you see your entire project context: Git repositories, design notes, and tasks, on a single map.
Features
- Spatial Canvas: Place blocks anywhere. What is close is related.
- Live Integrations: Embed repositories and issues directly on the canvas (GitHub, GitLab, Gitea, Forgejo).
- Rich Media: Support for Markdown notes, rendered Mermaid diagrams, images, links, and files.
- Multiplayer: Real-time collaboration with your team.
- Time Travel: View historical snapshots of your workspace to trace decisions.
- Git Versioning: Sync a project canvas to a Git repository, with notes and structure as versioned files.
- Self-Hosted: You own your data.
Getting Started
Requires Docker and Docker Compose.
1. Clone the repository (or download docker-compose.yml directly)
2. Copy the environment template and fill in the required values
cp env.example .env
Edit .env and set at minimum SECRET_KEY (generate with openssl rand -hex 32) and any DB credentials you want to change.
3. Start the stack
docker compose up -d
Once running, access the dashboard at: http://localhost:3000
Easypanel
Easypanel is a self-hosted Docker deployment platform, and Ideon has a one-click deployment template there.

The template sets up the required PostgreSQL database and a persistent volume for /app/storage automatically.
RepoCloud
One-click template, no other instructions required.

Contributing
If you've ever wanted to contribute to open source, and a great cause, now is your chance!
Bug reports, feature ideas, documentation improvements, and code contributions all matter.
Start here:
Contributors
Creator
Code Contributors
Thanks go to these wonderful people:
This project follows the all-contributors specification.
Contributions of any kind are welcome!
License
AGPLv3.
If you deploy Ideon publicly and modify it, you are expected to share the changes.