Rentomy

Rentomy is free open source cloud software for Residential Rental Property Managers, licensed under GNU Affero General Public License version 3.

To get started quickly, read the article on how to install Rentomy and run it in minutes.

Major new feature coming in 2019: electronic signatures that will allow contract signing with tenants, service providers, owners and employees. For example lease signing with tenants or listing agreements with owners will be covered by this feature. The git branch for this feature is at https://bitbucket.org/dasoftver/rentomy/src/sign_rentomy/ - do NOT use this branch as this is code in progress and thus unstable.

Current stable version is (as tagged in git repository).

This site has been last updated on Sun Jul 21 12:22:48 MST 2019.

This is the documentation for the latest Rentomy code. If you download older tagged versions from the git repository, each comes with 'docs' directory that contains the documentation matching that version.

    About
    License
    Running a Demo
    Features
    Help system
    Web Links to Sign-In and Available Properties
    Rentomy source code & Issue tracking
    Background jobs
    Backup
    Administrator login
    Changing Terms of Service and Privacy Policy
    Ping Alive service

About

Rentomy is free open source cloud software for Residential Rental Property Managers, licensed under GNU Affero General Public License version 3. Rentomy is comprehensive, fast & easy to use. Deploy it as a Software-as-a-Service (SaaS) on the web, or run it in-house.

License

Rentomy is licensed under GNU Affero General Public License version 3.

Running a Demo


When you download and install Rentomy, you can run it in demo mode: set ISDEMO variable to "yes" in appinfo file (an application configuration file) before starting the installation. Conversely, set ISDEMO to "no" to run a production version.

When run as a demo, it is a fully functional version, except that all data entered is deleted daily, around midnight - this includes your email address and all the data you entered.

Features


Cloud-based and FREE - with software source code

No software limits

Unpaid rent alerts

Online applications

Monthly statements

Repair & Maintenance

Transactions Management

Inspections reports

Integrate with your web site

Web portals

Web listings

Sharing of documents

Manage access

Quick access to data

Keep appointments

Quick sign-ups

No ads

Use any desktop, table or mobile device

Data safety

Poweful Admin Tools, Legal Compliance

Documents & Images

Scalable

Data backups

Manage employees

Help system


Rentomy is designed to be easy to use. If you need a 50 page manual to use any software, you'll probably never use it willingly.

With that in mind, Rentomy incorporates context sensitive Help in the application itself.

Hopefully by far most of the time you'd use Rentomy without needing this Help, as it was designed to be easy to use, clean and simple.

The context sensitive Help is in the form of a question mark (?) button next to the function you might be using - the idea is that you don't want to go back to documentation and try to identify where you are.

This Help is throughout Rentomy, including the Administrator's web pages.

Web Links to Sign-In and Available Properties

Sign-in link and link to available properties (with link to each available property) can be found under Settings from the Home page. Click Links to your web pages under Accessibility. You can then copy and paste those links to your web site as you see fit.

The sign-in link is the same for a manager and its employees, owners, tenants and service providers (each signs-in with their own email).

Rentomy source code & Issue tracking

Source code is available at Rentomy BitBucket repository.

Report issues at admin@dasoftver.org.

Background jobs


Rentomy installs several background jobs that run with different frequencies.

Daily jobs are:

Monthly jobs are:

Hourly jobs (every 6 hours starting midnight) are in cld_daily_job script:

Disk space checking (every 6 hours) is in cld_check_space script and it will alert you if disk space is 70% (or more) full.

If you're running Rentomy in Demo mode, every night at midnight all data and files are deleted (script cld_demo_job) - if you don't want this comment it out in /etc/crontab.

Backup


After Rentomy server is installed, copy setup_postfix and make_backup.sh scripts to the backup server and run them as below. The backup script will connect to the Rentomy server and ask for the user password and then setup only a passwordless pull of files from the production Rentomy server.

The backup keeps 30 days worth of backup. Rentomy doesn't actually keep 30 copies, but rather uses file links for unchanged files, saving space while allowing restoration from a point back in time.

Rentomy uses rsync pull system - the backup server copies files from primary automatically while primary disallows anything else (login, write etc.) by using authorized keys. Neither system can login to the other, except by password. This kind of password firewall allows for automation, while preventing a dangerous "trusted" primary/backup relationship in which both could be deleted if hackers broke into one of them.

Since Rentomy uses pull system for backup, you can backup production data to any number of backup servers (two backup servers at least recommended). Using multiple backup servers makes it easy to immediately switch to backup server if production goes down while still having another backup server, especially since restoring primary server (with potentially terabytes of data) may take hours or even days.

The Linux user hosting the backup must have sudo privilege. You can use this to add this user (we call it 'cld' here):
# Add user
useradd cld

# Set user password
passwd cld

# Add sudo to user
usermod -G wheel -a cld
To install backup for Rentomy:
# Login as the user who will hold backup data, copy make_backup here - this file must be copied from production system after the primary installation, since make_backup script is generated!
su - cld

# First install wget (if not already) and get setup_postfix script
sudo yum -y install wget
wget https://bitbucket.org/dasoftver/cloudgizer/raw/HEAD/setup_postfix -O setup_postfix

# Install e-mailing capability
chmod +x ./setup_postfix
sudo ./setup_postfix

# Install backup scripts
./make_backup.sh
Backup script is scheduled to run at 10:05pm every night and it sends status emails (okay or an error) to the email address specified in primary system's configuration file (config file). The emails are the status of database export and the status of pulling the backup files, assuring that both are done.

Backup includes database and all the files used by Rentomy. current-db directory is the current database export, and current_file directory is the current files backup.

Up to 30 directories for each (with names based on timestamps for easy perusing) are available for full backup of each in case you need to go deeper into the past.

Restoring backup consists of stopping Apache server, then running database export file in mysql command line utility, and copying files back to Rentomy's file directory, then restarting Apache server.

Administrator login


To access Administrator functionality, create a new user with email specified in config file, which is the same email as CLD_EMAIL in appinfo during installation.

Login as this user and you should see the Administrator page.

Changing Terms of Service and Privacy Policy


By default Rentomy is installed in Demo mode and the default terms apply. When you use Rentomy otherwise, i.e. when you set Demo mode to "no" in config file, you should provide your own terms of service and privacy policy.

Edit files terms.html and privacy.html in the html directory under Rentomy application home directory to specify your own Terms of Service and Privacy Policy. When changing these terms and policies, use Administrator tools to provide your users with the time and opportunity to read the new ones or opt out (Rentomy does this automatically once you start the process in Administrator console).

Ping Alive service


To check if Rentomy is alive use the following ping service provided:
https://yourserver/go.rentomy?page=ping
The result will be "OK" if service is up. Use this in monitoring software or services to check on the application uptime.

Copyright (c) DaSoftver LLC 2017. Cloudgizer is a trademark of DaSoftver LLC. Contact email address admin@dasoftver.org. The DaSoftver software and information herein are provided "AS IS" and without any warranties or guarantees of any kind.