Type to search across all documentation pages

Setup Your iTenance Account

Follow this step-by-step guide to configure your iTenance system after registering your account.

Getting Started Overview

After registering your account, you'll need to set up your system with essential configurations. This guide walks you through each step to get your iTenance ready for use.

Pro Tips

  • Start small: Create one category, group, unit, and permission set, then expand as needed.
  • Plan your structure: Before creating many items, plan your organizational hierarchy.
  • Use consistent naming: Use clear, descriptive names to make navigation easier.
  • Review permissions regularly: Ensure groups have appropriate access levels for security.

Phase 1: System Configuration (Setup Menu)

Start by configuring the fundamental settings in the Setup menu. These are the building blocks for your entire system.

Tip: You can use the Mass Import feature to quickly add multiple records at once. Just prepare a CSV file with the required data and upload it here.

📍 Access the Setup Menu

Log in to your iTenance account. In the main navigation menu on the top, look for the "Setup" option. Hover over it to expand the Setup menu.

What you'll see: The Setup menu will expand to show options like Categories, Groups, Permissions, and Units.

Setup Menu Screenshot

📁 Create Categories

Categories must be created before you can create tickets. Each category requires a type selected from predefined options (Emergency, Breakdown, Inspection, Regular). No default categories exist - you'll create categories that match your organization's workflow.

In the Setup menu, click on "Categories". Click the "Create" button. Enter a descriptive name for your category (e.g., "Preventive Maintenance", "Emergency Repairs", "Hardware"). Optionally add a description. Click "Save".

Step-by-Step:

1 In the top navigation, click Setup → Categories
2 Click the "Create" or "+" button
3
Fill in the required fields:
Enter Category Name (e.g., "Preventive Maintenance")
Select a Type from the dropdown (required): EM (Emergency - critical issues), BR (Breakdown - equipment failures), IN (Inspection - routine checks), or RE (Regular - standard maintenance)
Enter a Category Description (e.g., "Regular maintenance task")
Enter the Expected Time to Resolve in seconds (e.g., 86400 for 1 day, 14400 for 4 hours)
Select a Priority from the dropdown
4 Click "Save"
5 On the created category's page, toggle the Active switch to enable the category
6 You are now set up to use this category in maintenance tasks

Common Categories to Create:

Example categories you might create: "Electrical Maintenance" (type: EM), "HVAC Service" (type: RE), "Safety Inspection" (type: IN), "Equipment Repair" (type: BR), "Calibration" (type: RE), "Emergency Response" (type: EM).

👥 Create Groups

Groups define different roles and responsibility areas in your organization. You'll assign users to groups later.

From the Setup menu, click on "Groups". Click the "Create" button. Enter a group name (e.g., "Maintenance Team", "Supervisors", "Operators"). Select a Permission set that matches this group's responsibilities (we'll create permission sets next). Set the group as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Setup → Groups
2 Click the "Create" button
3
Fill in the required fields:
Enter Group Name (e.g., "Maintenance Team")
Select a Permission Set from the dropdown
4 Click "Save"
5 On the created group's page, toggle the Active switch to enable the group
6 You can now assign users to this group

Common Groups to Create:

Examples of groups: Maintenance Team, Supervisors, Operators, Administrators, Quality Inspectors, Logistics Staff.

🔐 Create Permission Sets

Permission sets control what each group can access and do in the system. This determines their level of access to different features.

From the Setup menu, click on "Permissions". Click the "Create" button. Enter a descriptive name (e.g., "Full Access", "Maintenance Only", "Read Only"). Select the appropriate permissions for each module (Locations, Machines, Suppliers, Parts, Units, Settings, Documentation, Reports, Schedule, Manufacturer, Language, Improvements, Status, Group, Category, Premises, Shelf, Inventory, Shift, User, Tickets, Tasks, Inspections, Items, Manifests, Usage, Comments, Activity, Notifications). Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Setup → Permissions
2 Click the "Create" button
3
Enter the required field:
Enter Permission Set Name (e.g., "Full Access", "Maintenance Only")
4
Configure permissions for each module by checking/unchecking boxes:
For Admin roles: Check all boxes to grant full access
For Maintenance roles: Select only maintenance-related permissions
For Limited roles: Select specific areas only
5 Click "Save"
6 On the created permission set's page, toggle the Active switch to enable the permission set
7 This permission set can now be assigned to groups

Permission Set Strategy:

Common permission levels: Full Access (view, create, edit, delete everything), Maintenance Access (manage maintenance-related items only), Read Only (view information without making changes), Limited Access (specific areas only).

📏 Create Units of Measurement

Units must be created before you can create Parts. Parts are measured in units, so you need to set up the appropriate units of measurement first (e.g., hours, pieces, kilometers, liters).

From the Setup menu, click on "Units". Click the "Create" button. Enter the unit name (e.g., "Hours", "Pieces", "Kilometers"). Enter a short code for the unit (e.g., "hr", "pc", "km"). Optionally add a description. Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Setup → Units
2 Click the "Create" button
3
Fill in the required fields:
Enter Unit Name (e.g., "Hours", "Pieces")
Enter Short Code (e.g., "hr", "pc") - this saves space in displays
4 Click "Save"
5 On the created unit's page, toggle the Active switch to enable the unit
6 You can now use this unit in parts and other measurements

Common Units to Create:

Examples of units: Hours (hr), Pieces (pc), Kilometers (km), Liters (lt), Kilograms (kg), Days (d), Minutes (min).

Phase 2: Organizational Structure (Logistics Section)

Now set up your physical locations and organizational hierarchy in the Logistics section.

🏢 Access the Logistics Section

In the main navigation menu, click on "Logistics". This will open the Logistics dashboard where you can manage your physical infrastructure.

Navigation Tip: You'll see "Logistics" in the top navigation. Click it to expand options for Premises, Locations, Assets, and more.

🏗️ Understanding Premises

Your first Premises is automatically created when you register your account, using your Company Name as the premises name. A Premises represents a main location or facility and is the top-level organizational unit. All data is scoped to the current premises - you will only see machines, users, units, tickets, locations, and other data that belong to the current premises. You can switch between premises using the premises switcher in the navigation menu.

In the Logistics section, look for "Premises" and click on it. Click the "Create" button. Enter the premises name (e.g., "Main Factory", "Head Office", "Warehouse A"). Enter the address of the premises. Select a currency for financial transactions at this location. Add any notes about the premises (e.g., "Monday-Friday operations"). Click "Save". The system will automatically assign you as the Maintenance Manager.

Step-by-Step:

1 Note: Your first premises is already created using your Company Name
2 To create additional premises, click Logistics → Premises in the top navigation
3
Click the "Create" button
getting-started.setup_premises_step_by_step.step3_substep1
4 Fill in the required field:
5 Click "Save"
6 On the created premises' page, toggle the Active switch to enable the premises
7 Switching Premises: Use the premises switcher in the navigation menu to switch between different premises

📍 Create Locations

Locations are areas within your premises. They help organize where your assets are physically located.

In the Logistics section, click on "Locations". Click the "Create" button. Enter a descriptive location name (e.g., "Workshop", "Assembly Line A", "Storage Room 1", "Building B - Floor 3"). Select the Premises this location belongs to. Add any relevant notes or details. Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Logistics → Locations
2 Click the "Create" button
3
Fill in the required fields:
Enter Location Name (e.g., "Workshop A", "Assembly Line 1")
Select the Premises this location belongs to
4 Click "Save"
5 On the created location's page, toggle the Active switch to enable the location
6 Machines and assets can now be assigned to this location

Location Organization Tips:

Examples of locations: Workshop, Assembly Line A, Assembly Line B, Storage Room 1, Building B - Floor 3, Maintenance Area, Quality Control Lab.

Phase 3: Asset Management (Assets & Related Data)

Set up your assets and supporting information to track all equipment and machinery.

Tip: You can use the Mass Import feature to quickly add multiple records at once. Just prepare a CSV file with the required data and upload it here.

🏭 Create Manufacturers

Manufacturers are the companies that produce your equipment and machines.

In the Assets section, look for "Manufacturers". Click the "Create" button. Enter the manufacturer name (e.g., "Siemens", "Bosch", "ABB"). Add contact information or website if available. Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Assets → Manufacturers
2 Click the "Create" button
3
Fill in the required field:
Enter Manufacturer Name (e.g., "Siemens", "Bosch")
4 Click "Save"
5 On the created manufacturer's page, toggle the Active switch to enable the manufacturer
6 You can now assign machines to this manufacturer

⚙️ Create Machines

Machines are the individual pieces of equipment you want to manage and maintain.

In the Assets section, click on "Machines". Click the "Create" button. Enter a descriptive machine name (e.g., "CNC Machine 01", "Hydraulic Press A"). Select the location where this machine is located. Select the manufacturer. Enter the machine model and serial number if available. Add specifications (power consumption, dimensions, etc.). Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Assets → Machines
2 Click the "Create" button
3
Fill in the required fields:
Enter Machine Name (e.g., "CNC Machine 01")
Select Location from the dropdown
Select Manufacturer from the dropdown
Enter Model (e.g., "CNC 2000 Pro")
Enter Manufactured Date
4 Click "Save"
5 On the created machine's page, toggle the Active switch to enable the machine
6 The machine is now ready for maintenance scheduling

🚚 Create Suppliers

Suppliers are vendors who provide parts, equipment, or services.

In the Assets section, click on "Suppliers". Click the "Create" button. Enter the supplier name. Add address, contact details, and payment terms if available. Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Assets → Suppliers
2 Click the "Create" button
3
Fill in the required field:
Enter Supplier Name
4 Click "Save"
5 On the created supplier's page, toggle the Active switch to enable the supplier
6 You can now link parts and services from this supplier

🔧 Create Parts

Parts are replaceable components used in maintenance and repairs.

In the Assets section, click on "Parts". Click the "Create" button. Enter the part name and description. Assign to a supplier. Set the unit of measurement (you created these earlier). Add part number and cost information. Set as "Active". Click "Save".

Step-by-Step:

1 In the top navigation, click Assets → Parts
2 Click the "Create" button
3
Fill in the required fields:
Enter Part Name
Enter Make
Enter Model
Enter Price
Select Unit of Measurement from the dropdown
4 Click "Save"
5 On the created part's page, toggle the Active switch to enable the part
6 The part is now available for use in maintenance tasks

Phase 4: Team Management

Create additional user accounts for your team members with appropriate group assignments.

👤 Create Additional Users

As an account administrator, you can add team members to the system and assign them to groups with appropriate permissions.

In the main navigation, look for "Users" or "Team Management". Click on "Users". Click the "Create" or "Add User" button. Enter the user's email address and name. Select the group(s) this user belongs to (e.g., "Maintenance Team", "Supervisors"). Set the account as "Active". The user will receive an email invitation to set their password. Click "Save".

Step-by-Step:

1 In the top navigation, click Users
2 Click the "Create" or "Add User" button
3
Fill in the required fields:
Enter user's Email Address
Enter user's First Name
Enter user's Last Name
Select a Group from the dropdown
4 Click "Save"
5 On the created user's page, toggle the Active switch to enable the user account
6 The new user will receive an email invitation to set up their account
7 Once they confirm their email, they can log in and start using the system

📧 User Invitation Process: After user creation, team members will receive an invitation email. They should click the link to set their password and complete their profile setup.

Next Steps

  • Create maintenance schedules for your machines
  • Assign tasks to team members
  • Track equipment maintenance history
  • Manage inventory and parts

🍪 Cookie Consent

We use essential cookies to provide core functionality like authentication and session management. Optional cookies help us remember your preferences. Learn more