reportms/app repository overview

⁠🐳 Report.ms – Official Docker Image

Report.ms is an open‑source low‑code platform for building enterprise web applications – from CRM and ERP to custom internal tools.
It combines the speed of visual design with the power of AI‑assisted development and Python scripting.

⁠✨ Key Features

• 🚀 Accelerated development – build apps through a visual editor and AI‑generated code.
• 🔓 Open & self‑hosted – run on your own infrastructure, no vendor lock‑in.
• 📈 Scalable – from small teams to government‑level organizations.
• 🤖 Built‑in AI – text generation, image recognition, speech‑to‑text, and more.
• 🐍 Python logic – extend every action, event, and scheduled task with Python scripts.

⁠🛠️ How to create your first app

Before running the server, you need an app definition – a folder with configuration files.

⁠1️⃣ Generate a new solution

Run the create command inside the Docker container:

docker run --rm -v "${PWD}:/app" reportms/app create "My first ERP"

This will create a folder named my-first-erp containing:

• app.rms – main application definition (data structures, roles, actions)
• site.rms – public website pages
• docker-compose.yml – ready‑to‑use compose file
• imgs/, scripts/, etc. – additional assets

⁠2️⃣ (Optional) Install VS Code extension

For better syntax highlighting and autocompletion when editing .rms files, install the Report.ms VS Code extension⁠.

⁠3️⃣ Run your newly created app

cd my-first-erp
docker run --rm -v "${PWD}:/app" -p 10000:10000 reportms/app

Your app will be available at http://localhost:10000.

⁠⚡ Quick start (if you already have a solution)

If you already have a folder with app.rms (or a generated project), just run:

docker run --rm -v "${PWD}:/app" -p 10000:10000 reportms/app

Then open your browser at http://localhost:10000.

⁠🛑 Stop & restart

Stop the container with Ctrl+C.

⁠💾 Persistent data with volumes

All your solutions (configuration files, images, scripts) are stored in the folder mounted to /app inside the container.
By default, the current directory (${PWD}) is used – this is where your app.rms, site.rms and data folders live.

To use a custom path for storing your solutions:

docker run -v /absolute/path/to/solutions:/app -p 10000:10000 reportms/app

⁠🌐 Changing the port

Map the container’s internal port (default 10000) to any port on your host:

docker run -p 8080:10000 reportms/app

Then access Report.ms at http://localhost:8080.

⁠🔧 Environment variables

⁠🐙 Docker Compose example

services:
  app:
    image: reportms/app:latest
    container_name: reportms
    ports:
      - "10000:10000"
    volumes:
      - ./solutions:/app

Start with:

docker-compose up -d

⁠📄 License

This Docker image contains Report.ms software distributed under the MIT License.
As with all Docker images, the user is responsible for compliance with any licenses of the software included inside the image.

⁠🔗 Resources

• 📖 Official Documentation⁠
• 🧪 VS Code Extension⁠