Rentomy

Rentomy is Free Open Source cloud software for Residential Rental Property Managers. Check out online fully-functional demo of Rentomy!

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

This site has been last updated on Fri Aug 17 13:39:39 MST 2018.

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
    Screenshots
    Online Demo
    Features
    Help system
    Download and Installation
    Web Links to Sign-In and Available Properties
    Rentomy Source Code
    Background jobs
    Backup
    Administrator login
    Changing Terms of Service and Privacy Policy
    Ping Alive service
    Installing from source

About

Rentomy is Free Open Source cloud software for Residential Rental Property Managers. Rentomy is comprehensive, fast & easy to use. Deploy it as a Software-as-a-Service (SaaS) on the web, or run it in-house.

Report issues or questions - go to Issue tracker.

License

Rentomy is licensed under GNU Affero General Public License, Version 3.0.

Screenshots


A few page screenshots are shown here online.

Online Demo


Rentomy Online Demo is a fully functional Demo. Note all data entered is deleted daily, around midnight - this includes your email address and all the data you entered.

To sign-up as a property manager, go to https://zigguro.org/go.rentomy?page=create_user. You'll get sign-in details in email, and the same goes for other users you create (owners, tenants, associates, service providers). Please use a valid email address in order to receive a verification email - the email address is used only for the demo (it's also deleted every night along any other data you may enter).

To login as Administrator (who manages property managers), go to https://zigguro.org/go.rentomy?page=login&manager_email=admin@zigguro.org. The user name (email) is admin@zigguro.org and the password is 1password!

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

Any issues, contact admin@zigguro.org.

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.

Download and Installation


Rentomy is written in C using Cloudgizer tool. Before installing Rentomy, install Cloudgizer first. Cloudgizer is also Free Open Source Software.

The installation for both Rentomy and Cloudgizer are designed to be automated if necessary, in case you'd like to install Rentomy without manual intervention.

#Get installation file
wget "https://zigguro.org/rentomy/rentomy.tar.gz" -O rentomy.tar.gz

######
#Unpack installation file, and install Rentomy
######
tar xzvfm rentomy.tar.gz
cd deploy

# Edit appinfo file, set these variable to match customer's environment:

#
# Use one of the following to install:
#

# to create application
cldgoapp create

# to update application
cldgoapp update
After the installation:
# Here is the sign-up link - you'd likely place it on your web site so property managers can sign up:
https://yourserver/go.rentomy?page=create_user

# Once you sign-up, you will get an email with your sign-in link - use that link to sign in.
Application is always deployed from binaries. If you distribute source code, then the end-user can recompile the source code by using cldbuild script.

Note that Rentomy enforces use of secure communication protocol (HTTPS). Apache (2.4.6 and later) comes with default installation of mod_ssl - you'd probably want to install trusted SSL certificates if you're running in production, otherwise you can test with the default.

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

Source code is available at Rentomy BitBucket repository.

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/zigguro/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


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.

Installing from source


Follow these instructions to make the installation file from source code. You must have installed Cloudgizer first.


  • Create installation file:
    cldpackapp

  • Now you have rentomy.tar.gz file that you can use to install Rentomy, see for details on that - the instructions are the same except that you already have rentomy.tar.gz and you won't use wget to get it.


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