For the complete documentation index, see llms.txt. This page is also available as Markdown.

🪪Root Account Setup

In this section, you’ll complete the initial setup for your root account, which serves as the main administrator account for your PayRam server. By the end, your root account will be ready to manage a


Prerequisites

Before you proceed with the onboarding configuration, make sure the following steps are completed:

  • Install the PayRam server and ensure it is running.

  • If you haven’t completed the installation, do that first by following the Installation Guide.


Root account setup

1

Open your PayRam server

  • In your browser, go to the IP address or domain where you hosted PayRam. The PayRam welcome page appears.

The PayRam welcome page
  • Seeing this page means your PayRam server is up and running.

Note: The Go to Payram buttons on this page open payram.com, not your own instance. To reach your setup screen, go to the signup URL in the next step.

2

Go to the signup page

  • In the address bar, add /signup to the address where you hosted PayRam.

    The addresses below are examples only — replace them with your own domain or server IP:

    Your setup
    Example signup URL

    Domain with SSL

    https://pay.example.com/signup

    Server IP, no SSL

    http://192.168.0.1/signup

    Installed on a different port

    http://192.168.0.1:3000/signup

  • The root account setup opens. This account has full administrative control over every configuration and setting.

Let's set up your root account
  • Select Next.

3

Enter your root email

  • Enter the email address for your root account. Remember it — this is the account you will log in with as the main administrator.

Entering the root account email
  • Select Continue.

4

Set your root password

  • Enter a password, then enter it again in Confirm Password.

Setting the root account password
  • Select Continue.

5

Choose how you will use PayRam

  • PayRam asks whether you are a Merchant or an Operator. Selecting either one reveals what it includes, so you can compare before you commit.

Choosing between Merchant and Operator
Mode
Choose it when

Merchant

Your customers pay you directly. This is the recommended option for most installs.

Operator

You onboard other merchants and earn a fee on their payments.

  • Select the mode you want, then select Continue.

6

Create your first project

  • A project holds the wallets, fees, branding and users for one website or product. Use your business or brand name so you can recognise it later in reports.

Creating your first project
  • Enter a project name, then select Continue → Invite teammate, or Skip to dashboard to finish now.

Note: You can rename a project later from Settings → Projects, and add more projects at any time.

7

Invite a teammate (optional)

  • If you continued, PayRam offers to add one teammate to the project straight away.

Inviting a teammate to the project
  • Choose the role they should have:

Role
What they can do

Project Admin

Manages wallets, fees, webhooks and branding, and can invite other members.

Project Lead

Runs day-to-day operations while you keep control of the wallets.

  • Enter their full name, email and a temporary password, then select Save and finish. Share those credentials with them privately.

  • This step is optional — select Skip to dashboard and add teammates later from Settings → User Management.


You have successfully completed the onboarding configuration. Now, proceed to Node Details Configuration to set up your dashboard settings.

Last updated