Deploy OpenConstructionERP
Open-source construction ERP: BOQ, takeoff, 4D schedule, 5D cost
openconstructionerp
Just deployed
/data
postgres
Just deployed
/var/lib/postgresql
Deploy and Host self hosted OpenConstructionERP (Other) on Railway
This template deploys OpenConstructionERP, an open-source construction ERP covering bills of quantities, takeoff, 4D scheduling and 5D cost, as an independent community packaging on Railway.
About Hosting OpenConstructionERP open-source software on Railway (self hosted OpenConstructionERP template)
OpenConstructionERP is AGPL-3.0 construction ERP software for bills of quantities, takeoff, 4D schedules and 5D cost models.
This is independent community packaging of datadrivenconstruction/OpenConstructionERP 19.7.0. It is not affiliated with or endorsed by OpenConstructionERP, DataDrivenConstruction, or Artem Boiko.
Why Deploy OpenConstructionERP, the self-hosted construction ERP on Railway
Running OpenConstructionERP on Railway keeps your BOQ, takeoff and cost data on infrastructure you control, without the per-seat fees a hosted construction ERP typically charges.
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 OpenConstructionERP 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 OpenConstructionERP self hosting
| Provider | What You Get with Railway | What You Get with the Other Provider |
|---|---|---|
| DigitalOcean | A template that wires the app and Postgres together, with a volume at /data and a health check on /api/health. | A droplet you configure yourself, including the OS, Docker and backups. |
| AWS | A template with private networking between services and no VPC to design first. | Wide control over networking and IAM, with more setup. |
| Hetzner | Deploys and restarts from the Railway dashboard, without logging in to update the stack. | Low-cost servers where you run Compose and handle updates, TLS and backups. |
Choose Railway for a quick start or a VPS.
Common Use Cases for hosted OpenConstructionERP
- Estimating a building project end to end: Build a BOQ, pull quantities from IFC, RVT or DWG models and PDF drawings, and price them against the cost databases in one workspace.
- Running 4D schedules and 5D cost models: Tie a Gantt programme to the model so you can see what gets built and when, and keep the cost model in step with it.
- Evaluating a construction ERP before committing: Deploy it, sign in, and explore the demo projects that load after first boot, so you see a populated system before entering your own data.
Dependencies for OpenConstructionERP Docker hosted on Railway
This template runs two services: a public openconstructionerp app on port 8080 and a private bundled Postgres database. Keep one replica of each service.
Deployment Dependencies for Managed OpenConstructionERP Service
The openconstructionerp service is public on port 8080, mounts a volume at /data, checks /api/health with a 600 second timeout, and uses the Always restart policy. Postgres is private, uses image postgres:16-alpine, stores files under /var/lib/postgresql, uses database postgres, and restarts On Failure. First boot loads demo data and can take a few minutes, which is why the health timeout is 600 seconds.
Implementation Details for OpenConstructionERP
The image is ghcr.io/onepush-dev/openconstructionerp:19.7.0, the unmodified upstream ghcr.io/datadrivenconstruction/openconstructionerp:19.7.0 image, with USER root because Railway volumes are root-owned (upstream runs as uid oe), plus railway/start.sh. The wrapper registers owner@example.com with OE_OWNER_PASSWORD on first boot and thereby claims the admin slot, because upstream would otherwise give admin to the first real registrant. Seeded demo accounts do not count as that first registrant. Later self-registrations are dormant viewers until an admin approves them. Baked values include OE_DB_PORT=5432, OE_DB_USER=postgres, OE_DB_NAME=postgres, OE_DATA_DIR=/data, VECTOR_DATA_DIR=/data/vectors, APP_ENV=production, SERVE_FRONTEND=true and OE_OWNER_EMAIL=owner@example.com. The upstream README describes 70 pre-loaded demo projects across 30+ countries. A recorded test of this packaging showed 13 projects visible to the demo admin on first login. AI features need your own LLM key in the app settings. Demo accounts can be removed later with DISABLE_DEMO_ACCOUNTS=1, which is not pre-set.
Nine template variables are generated or referenced, with no inputs: OE_OWNER_PASSWORD for owner@example.com, DEMO_USER_PASSWORD for demo@openconstructionerp.com, DEMO_ESTIMATOR_PASSWORD, DEMO_MANAGER_PASSWORD, JWT_SECRET, ALLOWED_ORIGINS (defaults to the Railway HTTPS domain), OE_DB_HOST and OE_DB_PASSWORD from postgres, and POSTGRES_PASSWORD on postgres.
How does OpenConstructionERP compare against other tools
OpenConstructionERP vs a hosted construction ERP (Hosted Construction ERP Alternative)
- Data location: OpenConstructionERP runs on infrastructure you control, so project data stays on your server. A hosted service handles operations for you, which helps if you have no one to run a server.
- Cost model: The software is AGPL-3.0 with no per-seat licence fee, so you pay for the host and any LLM provider you add. Hosted products often charge per user or per module.
- Feature depth: OpenConstructionERP covers BOQ, takeoff, 4D scheduling and 5D cost in one codebase. Mature hosted vendors often have deeper partner integrations.
OpenConstructionERP vs a local Docker Compose install (Local Docker Compose Alternative)
- Setup effort: A local Compose install needs Docker, a Postgres container, volumes you manage, and your own ports and TLS. This template provisions the app and Postgres as two services with a public domain and health check.
- Access: A local install is reachable only on your network unless you add a reverse proxy. The Railway deployment gives you a public HTTPS domain straight away, which suits a team across sites.
- Control: Local Compose gives you full control over the host, network and upgrade timing. The template is a fixed image with defaults chosen for you.
OpenConstructionERP with Docker vs Railway (Docker and Railway Comparison)
- Host ownership: Running the container yourself means you pick the machine, backups and patching. On Railway the platform runs the host and you manage variables and volumes.
- Startup behaviour: First boot loads demo data and can take a few minutes, which is why the health check timeout is 600 seconds. Expect the app to be ready after that window.
- Persistence: Keep the
/datavolume and the Postgres volume safe, and keep one replica of each service.
How to use OpenConstructionERP on Railway?
- Wait for first boot to finish. The demo data loads on first start and can take a few minutes, so do not panic if the app is slow at first.
- Open your Railway domain and sign in as owner@example.com with the value of OE_OWNER_PASSWORD from the service Variables.
- Or explore the demo projects as demo@openconstructionerp.com with DEMO_USER_PASSWORD. The default DemoPass1234! is rejected, so use the generated value.
- Change the owner email in your profile settings so the account matches your real address.
- Expect new self-registrations to wait for admin approval before they can do anything.
- If you add a custom domain, update ALLOWED_ORIGINS to include it, or logins from that domain will fail.
- Keep one replica of each service, since the local Postgres data and the /data volume are not shared.
- Check the health endpoint to confirm the app is up.
GET /api/health
How to self host OpenConstructionERP on other VPS Services (OpenConstructionERP self hosting guide)
Run OpenConstructionERP on your own VPS with the upstream flow: run the documented Docker Compose or image with a Postgres database and a data directory; see the upstream repository.
Clone the Repository
Clone the upstream source at the pinned release.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
git checkout v19.7.0
Install Dependencies
Install Docker and the Docker Compose plugin on your VPS.
Configure Environment Variables
Set a Postgres password, a JWT secret, and an owner password of your own.
OE_DB_HOST=db
OE_DB_PASSWORD=use-a-long-random-value
JWT_SECRET=use-a-long-random-value
ALLOWED_ORIGINS=https://your-domain
On a VPS you must also claim the admin slot yourself by creating owner@example.com before a stranger registers.
Start the OpenConstructionERP Application
Bring the stack up, then check the health endpoint.
Pricing and License of OpenConstructionERP (OpenConstructionERP pricing)
OpenConstructionERP is AGPL-3.0 open-source software, and this packaging is free to self-host under that license.
OpenConstructionERP hosted vs self hosted comparison (Pricing, features, costs, and more)
This template packages the AGPL-3.0 software.
Monthly cost of self hosting OpenConstructionERP on Railway
Railway bills on usage, so cost depends on RAM and CPU.
System Requirements for Hosting OpenConstructionERP on a VPS
Requirements depend on stored data and sign-ins.
Frequently Asked Questions (FAQs)
How do I sign in as the owner?
Sign in as owner@example.com with the password you find in the OE_OWNER_PASSWORD variable on the openconstructionerp service.
Why does the owner account exist?
Upstream gives admin to the first person who registers on a fresh install, which on a public URL could be a stranger.
Can I use the default demo password?
No.
What should I back up?
Back up the /data volume on openconstructionerp and the Postgres volume on postgres.
Do I need an LLM key to boot?
No.
Template Content
openconstructionerp
ghcr.io/onepush-dev/openconstructionerp:19.7.0postgres
postgres:16-alpine