Skip to main content

Handling your solutions

In iCure, a Solution represents a medical system, software or platform in which users' medical data are potentially managed through multiple IT stakeholders.

For example, let's take Petra Corp, developing solutions to help patients follow their menstruation cycle and share medical information linked to it with their gynecologist.

Petra Corp proposes to their patients the React Native App Petra, which allows them to encode their menstruation cycle data. The enterprise also has a second product called Petra Doc, allowing the gynecologists to follow the data their patients shared with them, and potentially make a diagnosis.

Petra Corp invoices the gynecologists and the Petra users who are using their solution using a monthly subscription.

Here is an example of Solutions Petra Corp could want to create:

Solutions created on Cockpit ValidRemarks
Petra, Petra DocThis scheme is inefficient, as patient data will have to be duplicated between Petra and Petra Doc. Moreover, as iCure allows you to share or not data with other actors, it will be easy in one Solution to define who can access which data
Petra, Petra InvoicingThis scheme seems efficient, as Petra Corp doesn't need medical data to create its invoices. Therefore, medical data can be isolated in one Solution, and invoicing information in another
Petra, Petra Invoicing, Hospital ABCIn case a hospital would like to work with Petra Corp and have a dedicated environment for their patients, Petra Corp could create a dedicated Solution for Hospital ABC

Of course, there are a lot more possible scenarios depending on the business needs of your solution. The most important to remember is that the choice is yours in the organisation of your environment, thanks to the Solutions.


Be aware that users of one solution will never be able to see the data of another solution, except if this user specifically authenticates with the other solution as well.

Create a solution

From the Cockpit dashboard screen, click on the Create solution card.

Create solution card

You'll see a 5 steps process to complete, in order to create your solution.

5-steps process

The 5 steps are self-explanatory and well documented. Go through each of them and provide the needed information.

At the end of the process, you will receive a series of information :

  • the EXTERNAL_SERVICES_SPEC_ID, identifying your Solution in our Authentication component;
  • the EMAIL_AUTHENTICATION_PROCESS_ID, identifying the email template to send to your users during their registration or login;
  • the PARENT_ORGANISATION_ID, identifying your organization as the responsible of the created users.
  • the FRIENDLY_CAPTCHA_SITE_KEY, if you chose to use the Friendly-Captcha temporarily provided by iCure.

Information that you will need when you'll want to start the development of your app.

Solution Created

Once your solution is created, click on Done.

Edit a solution

To edit an existing solution, click on the overflow menu, on the top-right of your solution card. Click afterwards on the Edit button.

Edit solution option

For now, you may only edit the name of your solution.

Save editing btn

Fill in the new solution name and click on the Save button.

Transfer ownership of a solution

iCure offers you the flexibility to transfer ownership of your solution to another environment seamlessly. This feature enables you to relocate your solution to a new environment while ensuring the safety of all your critical data, including databases, Health Care Providers (HCP), patient information, devices, and more.

Transfer solution option

The environment token, which is essential for the transfer process, should be supplied to you by the global administrator of the target environment where the solution is intended to be relocated. This token serves as the gateway to ensure secure and authorized transfers. The global administrator has the flexibility to provide you with the token through a method of their choice.

Operation token window

Delete a solution

To delete a solution, click on the overflow menu, on the top-right of your solution card. Click afterwards on Danger Zone > Delete.

Delete solution option

A modal appear.

Delete btn

To definitely delete the solution, write back its name into the dedicated input and click on Delete button.


Once you delete a solution, there is no going back: You won't be able to access the data contained in all databases of this solution anymore. Be aware that all children databases of this solution will also be affected by this operation.