Skip to content
/ r3 Public
forked from r3-team/r3

REI3 - Free and open low code

License

Notifications You must be signed in to change notification settings

KanRule/r3

 
 

Repository files navigation

r3_logo_git

REI3

Free and open low code
Build and host powerful applications with full control and ownership

Latest GitHub release Latest Linux x64 Latest Linux arm64 Latest Windows x64 GitHub go.mod Go version GitHub repo stars GitHub commit activity License

Live demo - News - Downloads - Documentation - Applications

Free yourself from walled gardens and cloud-only SaaS offerings. REI3 enables powerful low code applications, selfhosted in the cloud or on-premise. Create and then use, share or even sell your REI3 applications.

DEMO - Orgas DEMO - Gantt

⭐ Features

  • Fast results: Quickly replace grown, spreadsheet based 'solutions' with proper multi-user applications.
  • It can count: Summarize records, do date calculations, apply business rules and much more.
  • Make things visible: Show tasks on Gantt charts, generate diagrams or display information-dense lists.
  • Workflows included: Adjust forms based on the current state of a record, export to PDF or send notifications.
  • Compliance tools: With roles and access policies, REI3 can give and restrict access even on a per-record basis.
  • End-to-end encryption: Built-in support for E2EE - easy to use with integrated key management features.
  • Integration options: REI3 can serve as and connect to REST endpoints, create or import CSV files and also includes ICS access for regularly updating calendars on devices.
  • Ready for mobile: Works well on all devices, with specific mobile settings and PWA features for great-feeling apps.
  • Fulltext search: Users can quickly find desired content by using search phrases and language specific lookups.
  • Blazingly fast: REI3 is built to take advantage of multi-core processors and communicates with clients over bi-directional data channels.
  • Security features: Apply password policies, block brute-force attempts and enable MFA for your users.
  • Fully transparent: Directly read and even change data in the REI3 database - everything is human-readable.
  • Selfhosted: Run REI3 as you wish, locally or in the cloud - with full control on where your data is located.
  • Enterprise-ready: Adjust REI3 to your corporate identity, manage users & access via LDAP and grow with your organization by extending applications and clustering REI3.

DEMO - Calendar DEMO - Assets

🚀 Quickstart

Linux

  1. Extract the REI3 package (x64/arm64) to any location (like /opt/rei3) and make the binary r3 executable (chmod u+x r3).
  2. Copy the file config_template.json to config.json and fill in details to an empty, UTF8 encoded Postgres database. The DB user needs full permissions to this database.
  3. Install optional dependencies - ImageMagick & Ghostscript for image and PDF thumbnails (sudo apt install imagemagick ghostscript), PostgreSQL client utilities for integrated backups (sudo apt install postgresql-client).
  4. Register (sudo ./r3 -install) and start REI3 with your service manager (sudo systemctl start rei3).

Windows

  1. Setup the standalone version directly on any Windows Server with the installer.
  2. Optionally, install Ghostscript on the same Windows Server for PDF thumbnails.

Once running, REI3 is available at https://localhost (default port 443) with both username and password being admin. For the full documentation, visit rei3.de.

There are also Docker Compose files (x64/arm64) and a portable version for Windows available to quickly setup a test or development system.

💡 Where to get help

You can visit our community forum for anything related to REI3. The full documentation is available on rei3.de, including documentation for admins and application authors as well as Youtube videos.

👏 Thank you

REI3 would not be possible without the help of our contributors and people using REI3 and providing feedback for continous improvement. So thank you to everybody involved with the REI3 project!

Stargazers repo roster for @r3-team/r3

REI3 is built on-top of amazing open source software and technologies. Naming them all would take pages, but here are some core libraries and software that helped shape REI3:

  • Golang to enable state-of-the-art web services and robust code even on multi-threaded systems.
  • PostgreSQL for powerful features and the most reliable database management system we´ve ever had the pleasure to work with.
  • Vue.js to provide stable and efficient frontend components and to make working with user interfaces fun.

👍 How to contribute

Contributions are always welcome - feel free to fork and submit pull requests.

REI3 follows a four-digit versioning syntax, such as 3.2.0.4246 (MAJOR.MINOR.PATCH.BUILD). The major release will stay at 3 indefinitely, while we introduce new features and database changes with each minor release. Patch releases primarily focus on fixes, but may include small features as long as the database is not changed.

The branch main will contain the currently released minor version of REI3; patches for this version can directly be submitted for the main branch. Each new minor release will use a separate branch, which will merge with main once the latest minor version is released.

🔩 Build REI3 yourself

If you want to build REI3 itself, you can fork this repo or download the source code to build your own executable. The master branch contains the current minor release, while new minor releases are managed in new branches.

  1. Install the latest version of Golang.
  2. Go into the source code directory (where r3.go is located) and execute: go build -ldflags "-X main.appVersion={YOUR_APP_VERSION}".
    • Replace {YOUR_APP_VERSION} with the version of the extracted source code. Example: go build -ldflags "-X main.appVersion=2.5.1.2980"
    • You can change the build version anytime. If you want to upgrade the major/minor version numbers however, you need to deal with upgrading the REI3 database (see db/upgrade/upgrade.go).
    • By setting the environment parameter GOOS, you can cross-compile for other systems (GOOS=windows, GOOS=linux, ...).
    • Static resource files (HTML, JS, CSS, etc.) are embedded into the binary during compilation - so changes to these files are only reflected after you recompile. Alternatively, you can use the -wwwpath command line argument to load REI3 with an external www directory, in which you can make changes directly.
  3. Use your new, compiled binary of REI3 to replace an already installed one.
  4. You can now start your own REI3 version. Make sure to clear all browser caches after creating/updating your own version.

📃 License

REI3 © 2019-2024 Gabriel Victor Herbert - released under the MIT license.

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 48.4%
  • Go 40.1%
  • HTML 6.4%
  • CSS 5.1%