How to set up a new ISP in saRa

Who does this: The platform Owner or a super admin creates the ISP; then the ISP's first administrator sets it up
Permission: platform.manage (Owner / super admin) for Add ISP; ISP details, Branches, and moving subscribers between them, Areas and sub-areas etc. for the ISP admin (an ISP administrator holds everything inside their ISP)

Settings: tabs for ISP details, subscriber rules, SMS and email, payments, billing, security and more

Steps

Sign in at /login as the Owner or a super admin and open Platform → ISPs.
The Owner login is made on the server with the command 'isp owner create <user>'; super admins are added by the Owner under Platform → Administrators → Add super admin.
Click Add ISP (a large popup).
The platform dashboard has the same button.
In the section The ISP fill Name customers know it by and Code, pick the Time zone, and add Phone, Email, Address, Owner, Registration number, Website, Facebook page, Instagram and YouTube channel if you want.
The Code is short and permanent (2 to 32 small letters, digits or dashes, starting with a letter or digit): it becomes the ISP's Quick Pay link /pay/<code> and its RADIUS group name, so it cannot be changed later. The time zone is used for expiry times, reminders and reports.
In the section Its first administrator fill Full name, Username, Mobile, Email (optional), CNIC and Password.
The password needs at least 8 characters with letters and a number or symbol. Give it to the administrator; they sign in at /login.
Click Add ISP.
saRa shows 'ISP added. <username> can sign in at /login now and set it up.' and opens the new ISP's page with tabs Administrators, Branches and Details.
Optional, on the ISP page: use the More menu for Add administrator, Logo, Browser icon and App keys, or press Open this ISP to work inside it as the Owner / super admin.
Switch off ISP (also in More) stops every staff, partner and customer sign-in of that ISP; its customers' internet keeps working. Switch on again reverses it.
The ISP's administrator signs in at /login and opens Settings (the last menu entry) → General: check Name customers know you by, NTN, contact details, Time zone, address and the Note at the bottom of invoices, then click Save ISP details.
Other Settings tabs: Subscriber rules, SMS and email, Payments, Billing, Security, API, Appearance, Customer portal, Modules.
Add the office structure: Staff → Branches → Add branch (Branch name, Phone, Address) and Area → Areas → Add city / Add area.
Branches are optional; once they exist, staff placed in a branch see only that branch's subscribers and cash.
Then follow the next guides in order: add a router (Network → NAS / routers), create packages (Packages → Packages), add staff (Staff → Staff), add subscribers (Subscribers → All subscribers).
Settings → Billing also has Pause automatic billing for ISPs moving over from another billing system.

What saRa does

saRa creates the ISP with its default settings, a built-in ISP Admin hook role (administrator level, never given to staff), the six default staff roles (Manager, Accountant, Recovery officer, Support, Technician, Counter staff), the default customer role, the first administrator login, and the RADIUS group for expired customers (Framed-Pool expired-pool and Mikrotik-Address-List expired). All of the ISP's data is separated from other ISPs by PostgreSQL row-level security.

Good to know

One saRa installation serves many ISPs; each ISP only ever sees its own data.
Platform → Platform settings holds platform-wide rules such as whether administrators must use two-step sign-in.
Platform → Move subscribers moves subscribers between ISPs.