{"id":716,"date":"2023-11-27T10:43:44","date_gmt":"2023-11-27T09:43:44","guid":{"rendered":"https:\/\/amagnoapp.help\/help\/connection-to-an-amagno-server\/"},"modified":"2026-02-24T16:37:00","modified_gmt":"2026-02-24T15:37:00","slug":"connection-to-an-amagno-server","status":"publish","type":"docs","link":"https:\/\/help.amagno.de\/en\/docs\/amagno-app\/get-started\/log-in-and-log-out\/connection-to-an-amagno-server\/","title":{"rendered":"Connection to an Amagno server"},"content":{"rendered":"

The connection with another Amagno service requires clear prerequisites. This article provides information and helps with error analysis.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The app is currently not delivered on an on-premise system and must currently be delivered via the Internet using our app server. Only in later versions will the Amagno Mobile Explorer of the local on-premise system be replaced by the web interface of the app.<\/p>\n\n\n\n

The app has the option of connecting to an Amagno server that meets the requirements below. <\/p>\n\n\n\n

<\/path><\/svg><\/div>
<\/div>

Important: <\/strong>The app always requires the latest available on-premise version, as the app is provided centrally on the Internet and this requires the latest Rest API. If you want to use the app for On Premise<\/a>, you must install the latest On Premise<\/a> updates (update contract required).<\/p><\/div><\/div>\n\n\n\n

To do this, click on the connection tab (A) at the bottom. The Connections<\/strong> dialog appears.<\/p>\n\n\n\n

In the input line of Add<\/strong> (B), enter the server address accessible from the Internet that refers to the instance of the IIS (Internet Information Server) of the Amagno server. The API of the Amagno server must be accessible via this according to a standard installation (see server documentation<\/a>).<\/p>\n\n\n\n

Example:<\/strong><\/p>\n\n\n\n

In the company, the necessary API is available on the Amagno server with an internal IP xxx.xxx.xxx.xxx<\/em> at https:\/\/xxx.xxx.xxx.xxx\/amagnome\/api\/internal<\/em><\/strong>. For access from the Internet, the server must currently be accessible via an external IP address<\/strong> (possibly a domain). Ask your system administrator about this.<\/p>\n\n\n\n

Only the internal IP xxx.xxx.xxx.xxx<\/em> is therefore the connection URL<\/strong> that is entered in the input field of Add<\/strong> (B). The rest of the URL is put together automatically by the app. Then press the Enter\/Return<\/strong> button and Amagno will start the connection setup.<\/p>\n\n\n\n

<\/path><\/svg><\/div>
<\/div>

First check from outside the company whether the URL with the external URL\/domain can be accessed via a browser, i.e. https:\/\/xxx.xxx.xxx.xxx\/amagnome\/api\/internal<\/em><\/strong> The API documentation via Swagger should appear here. If the call is unsuccessful, please contact your system administrator, as the causes may be numerous and lie outside the scope of support from Amagno or an Amagno partner providing you with support.<\/p><\/div><\/div>\n\n\n\n

The connection is saved in Select<\/strong> (C) after a successful login on the current device. The connection can be changed or deleted in the connection overview (C).<\/p>\n\n\n\n

Prerequisites<\/h2>\n\n\n\n

These requirements are all necessary for a successful connection to an Amagno server:<\/p>\n\n\n\n