Installation

Installed in about ten minutes

No SSH, no Composer, no build step. Upload, create a database, answer three screens.

Download and extract

Get the archive from your client area and extract it into your hosting account. Point your domain at the public directory. On cPanel that means setting the document root to recurnix/public, or extracting so that public becomes your public_html.

Create a database

In your control panel create one MySQL database and one user, then grant that user all privileges on it. Keep the database name, username and password to hand for the next step.

Open your domain

Visit your site in a browser. Recurnix generates its own application key on first boot and takes you to the installer. It checks PHP version, extensions and directory permissions, and tells you plainly if anything is missing.

Enter the database details

Paste the database name, user and password. The installer writes your configuration, runs migrations and seeds the default currencies, roles and settings.

Create your admin account

The first account you create becomes the owner and holds every permission. When the installer finishes it locks itself: the install routes return 404 from then on, so nobody can re-run it against your live system.

Add the cron entry

One line makes renewals, retries, reminders, usage sync and backups run on schedule.

# Runs every minute. Laravel decides what is actually due.
* * * * * cd /home/youruser/recurnix && php artisan schedule:run >/dev/null 2>&1

Licensing

Activating your licence

Your licence key is shown on the downloads page in your client area, in the form RCX-XXXX-XXXX-XXXX-XXXX. Add it to your .env file:

RECURNIX_LICENSE_KEY=RCX-XXXX-XXXX-XXXX-XXXX

Your installation then confirms the licence on a schedule. If it cannot reach us, or your subscription lapses, nothing stops working. After a grace period you will see a notice in your admin panel and that is the entire consequence. Your invoicing is not ours to interrupt.

Troubleshooting

If something goes wrong

The installer says a PHP extension is missing

Enable it from your control panel. On cPanel this is under Select PHP Version, then Extensions. The installer names exactly which one it wants. You do not need to restart anything.

I get a blank page or a 500 error

Check that your document root points at the public directory and not at the application root. Then confirm storage and bootstrap/cache are writable by your web user.

The installer returns 404

That means the install already completed. The installer deliberately disappears once finished. If you need to start over, remove storage/installed.lock and empty the database first.

Renewals and reminders are not running

The cron entry is missing or pointing at the wrong directory. It must run from the application root, the one containing artisan. Check it with php artisan schedule:list.

How do I upgrade to a new version?

Download the new archive from your client area, back up your database and your .env, replace the application files while keeping .env and storage, then run migrations. The changelog notes anything unusual for that release.

Stuck on something?

Open a ticket in your client area, or send us a message. A real person reads it.

Open a ticket Contact us