Deploy Ideon

Notes, repos, tasks and files on one collaborative canvas

Deploy Ideon

Just deployed

/app/storage

Just deployed

/var/lib/postgresql

Deploy and Host self hosted Ideon (Other) on Railway

This template deploys Ideon, a self-hosted infinite-canvas workspace, as independent community packaging of 3xpyth0n/ideon v1.2.0 (AGPL-3.0). It is not affiliated with or endorsed by Ideon.

About Hosting Ideon open-source software on Railway (self hosted Ideon template)

This template runs the unmodified upstream Ideon image, the AGPL-3.0 workspace from 3xpyth0n/ideon v1.2.0, with a small Railway layer of baked defaults.

Railway provisions both services, wires the private Postgres connection, generates SECRET_KEY and the database password, and runs the /api/health check.

Why Deploy Ideon, the self-hosted infinite-canvas workspace on Railway

Self-hosting Ideon on Railway keeps your notes, tasks and files on infrastructure you control, rather than in a hosted canvas workspace that charges per seat.

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Ideon on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

Railway vs Other Hosting Providers and VPS for Ideon self hosting

Running Ideon yourself means choosing where the two services live, and the trade-off is how much infrastructure you manage.

ProviderWhat You Get with RailwayWhat You Get with the Other Provider
DigitalOceanBoth services deploy from one template with a public domain and a volume.A Droplet with root access, where you install Docker and manage Postgres and TLS yourself.
AWSA single click gets a working instance without VPC or security group setup.Broad managed services and fine-grained networking, which take more time to configure.
HetznerThe template handles the container, health check and restart policy for you.A low-cost server with strong resources, where you own every layer from the OS up.

Pick Railway if you want the stack running quickly, and pick a VPS if you want direct control over the machine.

Common Use Cases for hosted Ideon

  • Project planning on one map: A small team can put notes, tasks and kanban-style boards on a single canvas, so the whole project is visible at once instead of spread across several tabs.
  • Repository overview next to the work: You can place Git repository stats beside the notes and tasks that depend on them, which keeps code context close to the decisions being made.
  • Shared file storage: Files you upload land on the persistent volume mounted at /app/storage, so they survive redeploys as long as that volume stays attached.
  • Durable structured data: Canvas content, tasks and account data live in the bundled Postgres service, which keeps the app itself stateless apart from its files.
  • Private team workspace: Because the first visitor to /setup becomes the admin and public registration stays off afterwards, you can keep a project workspace limited to people you invite.

Dependencies for Ideon Docker hosted on Railway

This template runs two services. The ideon service is the public web app, and postgres holds the data on a private network. Keep one replica of each.

Deployment Dependencies for Managed Ideon Service

The ideon service is public on port 8080, with a volume at /app/storage, a health check at /api/health with a 300 second timeout, and a restart policy of Always. The postgres service is private postgres:17-alpine, with a volume at /var/lib/postgresql and restart policy On Failure. Keep one replica of each service, because the volumes hold local persistent state.

Implementation Details for Ideon

The image ghcr.io/onepush-dev/ideon:1.2.0 is the unmodified upstream ghcr.io/3xpyth0n/ideon:1.2.0 image with Railway defaults baked in, including SHELL_MAX_SESSIONS=0, which disables the in-app Shell block. Users can re-enable the Shell block at their own risk by adding a SHELL_MAX_SESSIONS service variable. The baked APP_PORT=3000 value is ignored, because Railway injects PORT=8080, the app listens on 8080, and the public domain targets 8080. Also baked are DB_PORT=5432, DB_NAME=postgres, DB_USER=postgres, TIMEZONE=UTC and LOG_LEVEL=info. SECRET_KEY is a generated 64-character value; keep it stable and never rotate it, because rotating it logs everyone out and makes encrypted data unreadable.

The template sets five variables, and you supply no inputs. APP_URL is the Railway HTTPS domain and should be updated for a custom domain. SECRET_KEY is a generated 64-character key that you must keep stable and never rotate. DB_HOST and DB_PASS come from the postgres service, and POSTGRES_PASSWORD is set on that service.

How does Ideon compare against other tools

Ideon vs a hosted canvas workspace (Hosted Canvas Alternative)

  • Data location: Ideon runs in your own Railway project, so notes, files and Postgres data stay under your control.
  • Cost model: The software is AGPL-3.0 and free to self-host, and you pay only for infrastructure, while hosted canvases often charge per seat or plan.
  • Polish and support: A hosted canvas usually wins on polish, onboarding and vendor support, and here you handle updates and backups yourself.

Ideon vs keeping project notes in scattered documents (Scattered Documents Alternative)

  • Spatial context: Ideon places notes, tasks and files on one shared canvas, so relationships are visible at a glance.
  • Collaboration: Realtime collaboration keeps several people on the same map, while scattered documents often drift out of sync.
  • Simplicity: A folder of documents is simpler and needs no service to run, so it stays the better choice for small, short-lived notes.

Ideon with Docker vs Railway (Docker Alternative)

  • Setup effort: Railway offers a one-click template with generated SECRET_KEY and Postgres password, while Docker means wiring containers, volumes and variables yourself.
  • Control: Docker on your own machine or VPS gives full control over the host, networking and backups, which Railway abstracts away.
  • Operations: Railway applies the health check (/api/health, timeout 300 seconds) and restart policies for you, while with Docker you configure and monitor them yourself.

How to use Ideon on Railway?

  1. Open the public domain right after the deploy finishes. The root path redirects to /setup.
  2. Complete the setup wizard. The first visitor becomes the admin, and public registration stays disabled afterwards.
  3. Keep SECRET_KEY stable and never rotate it. Rotating it logs everyone out and makes encrypted data unreadable.
  4. Update APP_URL if you add a custom domain, then point the domain at the ideon service.
  5. Keep one replica of each service. Local volumes at /app/storage and for Postgres do not support multiple replicas.
  6. Check /api/health to confirm the instance is healthy. The health check uses a 300 second timeout.
GET /api/health

How to self host Ideon on other VPS Services (Ideon self hosting guide)

Clone the Repository

Clone the upstream repository and check out the v1.2.0 tag so you run the same code the image is built from.

git clone https://github.com/3xpyth0n/ideon.git
cd ideon
git checkout v1.2.0

Install Dependencies

You need a Linux VPS with Docker and Docker Compose installed.

docker --version
docker compose version

Configure Environment Variables

Create a stable SECRET_KEY once and never rotate it, because it signs session tokens and derives encryption keys.

export APP_URL=https://your-domain
export SECRET_KEY=your-64-character-secret
export POSTGRES_PASSWORD=your-database-password
export SHELL_MAX_SESSIONS=0

Start the Ideon Application

Start the stack with the documented upstream flow for the Ideon container and Postgres. See the upstream repository for the compose file and commands.

Pricing and License of Ideon (Ideon pricing)

Ideon is open-source software released under the AGPL-3.0 license, and you can self-host it for free.

Ideon hosted vs self hosted comparison (Pricing, features, costs, and more)

This template packages the AGPL-3.0 software, and no hosted canvas plan prices are quoted here. Your costs come from the infrastructure you run it on.

Monthly cost of self hosting Ideon on Railway

Railway bills on usage, so the monthly cost depends on the RAM, CPU, volume size and services you run. Check your usage in the Railway dashboard after the first few days.

System Requirements for Hosting Ideon on a VPS

A VPS needs enough memory and disk for the application, a Postgres 17 database and your stored files. Start modest and watch memory and disk use before you upgrade.

Frequently Asked Questions (FAQs)

How do I create the admin account?

Open the public domain right after deploy. The root path redirects to /setup, and the first visitor to /setup becomes the admin. Public registration stays disabled afterwards, so complete setup before anyone else can reach the URL.

Is the Shell block turned on?

No. SHELL_MAX_SESSIONS is baked to 0, which disables the in-app Shell and PTY. You can re-enable it by adding a SHELL_MAX_SESSIONS service variable, but that is at your own risk.

Can I rotate SECRET_KEY?

No, never rotate it. SECRET_KEY signs session tokens and derives encryption keys, so rotating it logs everyone out and makes encrypted data unreadable. Keep it stable.

What should I back up?

Back up the /app/storage volume on the ideon service, the Postgres volume at /var/lib/postgresql, and your SECRET_KEY value. You need all three to restore a working instance.

Is this affiliated with Ideon?

No. This is an independent community packaging of 3xpyth0n/ideon v1.2.0 (AGPL-3.0), and it is not affiliated with or endorsed by Ideon.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0