rentroo

Rentro is a free, easy-to-use desktop application designed to help landlords manage their properties and rentals without the hassle. It serves as a single place for you to keep track of your properties, tenants, leases, and rent payments.

Getting Started (Desktop App)

The easiest way to use Rentro is to download the ready-made desktop application for your computer.

1. Go to the Releases page.
2. Download the version for your operating system (e.g., .exe for Windows, .dmg for Mac, .AppImage for Linux).
3. Install and run the application. No complex setup or servers required!

Key Features

• Centralized Property and Tenant Information: Rentro allows landlords to store all property and tenant details in one convenient location. From property specifications to tenant records and contact information.

• Rent Lease Creation: Rentro simplifies the process of creating rent leases. It offers customizable templates that enable landlords to generate lease.

• Rent Payment Tracking: Rentro provides a comprehensive system for tracking rent payments, helping landlords stay updated on transactions and promptly address any overdue payments.

• Custom Document Generation: Rentro allows landlords to create custom documents for effective communication with tenants. Personalized letters, notices, and announcements can be generated to ensure clear and consistent correspondence.

• Collaboration: Whether you are an independent landlord or manage a real estate business with multiple collaborators, Rentro supports collaboration and facilitates task coordination within teams.

Screenshots

Rents page	Send notices, receipt by email	Pay a rent
Tenants page	Tenant details
Properties page	Property details
Landlord page	Template leases	Author a contract
Members

Self-host the application

Prerequisite

• Install Docker and Compose

Download the docker-compose.yml file

mkdir mre
cd mre
curl https://raw.githubusercontent.com/rentroo/rentroo/master/docker-compose.yml > docker-compose.yml
curl https://raw.githubusercontent.com/rentroo/rentroo/master/.env.domain > .env

Update the secrets and tokens in the .env file (at the end of the file).

🚨 IMPORTANT

In case you previously ran the application, the secrets, the tokens and the MONGO_URL must be reported from previous .env file to the new one. Otherwise, the application will not point to the correct database and will not be able to login with the previous credentials.

Localhost setup

Start the application under localhost:

APP_PORT=8080 docker compose --profile local up

The application will be available on http://localhost:8080/landlord and http://localhost:8080/tenant.

Ip setup

Start the application under a custom ip:

sudo APP_DOMAIN=x.x.x.x docker compose up

x.x.x.x is the ip address of the server.

The application will be available on http://x.x.x.x/landlord and http://x.x.x.x/tenant.

In case you need to use a port number do not pass it in the APP_DOMAIN. You can use the APP_PORT environment variable.

Domain with https setup

Start the app under a custom domain over https:

sudo APP_DOMAIN=app.example.com APP_PROTOCOL=https docker compose up

Make sure your DNS records are pointing to the private server. The application will automatically issue the ssl certificate.

The application will be available on https://app.example.com/landlord and https://app.example.com/tenant.

Backup and restore the data

The backup and restore commands can be executed when the application is running to allow connecting to MongoDB.

Backup

In the mre directory run:

docker compose run mongo /usr/bin/mongodump --uri=mongodb://mongo/mredb --gzip --archive=./backup/mredb-$(date +%F_%T).dump

Replace "mredb" with the name of your database (see .env file). By default, the database name is "mredb".

The archive file will be placed in the "backup" folder.

Restore

In the mre/backup directory, select an archive file you want to restore.

Then run the restore command:

docker compose run mongo /usr/bin/mongorestore --uri=mongodb://mongo/mredb --drop --gzip --archive=./backup/mredb-XXXX.dump 

Where mredb-XXXX.dump is the archive file you selected.

Again, replace "mredb" with the name of your database (see .env file). By default, the database name is "mredb".

Developers

To run the application in development mode, follow the steps outlined in the documentation available here

Donate

Thank you for your interest in supporting Rentro. Every contribution will help us pay our ongoing maintenance and development costs 🙏

Contact

LinkedIn: www.linkedin.com/in/caissani

X: @camelaissani

License

The project is licensed under the MIT License. To view the license details, please follow the link below:

MIT License

Feel free to review the license terms and conditions to understand the permissions and restrictions associated with the project.