Installing and using the Maxon App on Linux

Netinho Da Costa
Netinho Da Costa
  • Updated


Topics covered:

  1. Getting started with the Maxon app on Linux
    1. a) Downloading the Maxon app
    2. b) Installing the Maxon app
    3. c) Uninstalling the Maxon app
    4. d) Loggin in and out of your account
    5. e) Listing your licenses
    6. f) Trial licenses
  2. Technical support
    1. a) Submitting a support ticket
    2. b) Redshift-related license errors
  3. Advanced use cases (aimed at technical directors or system administrators)
    1. a) Verifying that the service is available
    2. b) Verifying that the service is running
    3. c) Licensing Workflows
    4. d) Listing your products
    5. e) An overview of all available commands:

1) Getting started with the Maxon App on Linux

a) Downloading the Maxon App

Go to and download the Linux version of the Maxon App. That will download a file called 

b) Installing the Maxon App

Open a terminal window, and cd to the directory where you downloaded the Maxon app

Alternatively, you can go to that location, right-click, and select 'Open in Terminal'. 

For example:


Then in the terminal run

sudo sh --target /opt/maxon




c) Uninstalling the Maxon App

In order to uninstall the Maxon app, you can run the following command:

First, go to the following path:


In there you will find a file.

sudo sh



d) Logging in and out of your account

To log in, you'll need your email and password used for your Maxon account.
First, go to the following path where you can find the mx1 file:


In there you will be able to use mx1. You can use mx1 in order to log in.

./mx1 user login -u
Enter password: mypassword

To log out, you can use the following command:

./mx1 user logout

e) Listing your licenses

You are able to use mx1 to activate your license. This step is not required if you only have one license. Logging in to your Maxon account would be sufficient in that case.

However if you want to choose between different licenses, or if you want to deactivate your license on machine A, in order to activate it on machine B. In cases like that this step is required.


To list your licenses, run:

./mx1 license list

The tool will output the list of licenses available in the user account, their activation status, and the validity period. For example:

Activating and Deactivating specific licenses

To activate a license run 

./mx1 license assign <license_identifier>

For example:

./mx1 license assign

This will result in: Successfully assigned a license for whatever identifier you selected.

Assign example:

Similarly to deactivate a license use the release command. For example:

./mx1 license release
Successfully release ''.

Release example:


Trial licenses

Trial licenses are started with the following command

./mx1 license trial start

2) Technical support

If you are experiencing issues with the Maxon app, please first follow these steps in order to force a reset on your license.

  1. from, release the license
  2. uninstall Maxon App (by the method shown above)
  3. install the latest Maxon App version
  4. log into your account using ./mx1
  5. use ./mx1 license list to check the licensing status - the license should show "activated"

a) Requesting technical support via a ticket

If your license not working as expected and you require technical support. You can create a support ticket here:

If you decide to ask for help by submitting a support ticket for an issue related to your license on Linux. Please make sure to also provide the following:


Please provide the following two files:

To get the Maxon app log file on Linux you will find it at the following location. (This file is important to share with support when you create a ticket at our support center.)


As well as the database file located at:


b) A Redshift license issue

If your error is related to any license issue with Redshift, in that case, please also provide the latest Redshift log file. (ideally right after getting an error) On Linux, you will be able to locate the Redshift log file here:


In there you will find a file called log.html.
Please make sure to attach that file if your error is related to an issue with Redshift.







3) Advanced use cases
(aimed at technical directors or system administrators)


a) Verifying that the service is available


./mx1 service info

If the service is running you should see something like this:


However, the service isn't available you'll see this error instead:

Error: Request failed. Service might be unavailable.

In that case, ensure that the service has started by running:

systemctl start maxon_app.service 

and verifying the status with:

systemctl status maxon_app.service


b) Verifying that the service is running

Verifying that the service is running

To verify that the service is running, run:

systemctl status maxon_app.service

If the service is available you will see something like this:

● maxon_app.service - Maxon App Service
   Loaded: loaded (/etc/systemd/system/maxon_app.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-09-01 15:05:20 CEST; 11min ago
 Main PID: 992 (
    Tasks: 16 (limit: 48088)
   Memory: 15.9M
   CGroup: /system.slice/maxon_app.service
           ├─992 /bin/bash /opt/maxon/maxon_app/bin/
           └─993 /opt/maxon/maxon_app/bin/maxon_appd

c) Licensing Workflows

Licenses are managed with the mx1 command-line tool. By default, the tool is available in:


d) Listing your products

To see the products available for activation in your account, use the following command:

 ./mx1 product list 

For example:



e) An overview of all available commands:

The MX1 tool is shipped with the Maxon App installer on Mac and Windows. It's also included on Linux with our newest Maxon App releases. The MX1 tool offers abilities to log in/out of an account, activate/deactivate a license using the command line. 

The install location:

Mac: Library/Application Support/Maxon/Tools

Windows: C:\Program Files\Maxon\Tools

Linux: opt/maxon/maxon_app/bin

How to use it:


  1. Launch Terminal
  2. cd to the Maxon App Tools folder 

    cd /Library/Application\ Support/Maxon/Tools 

  3. Type ./mx1 then the command, e.g., ./mx1 user login -u -p 12345


  1. Open Command Prompt
  2. cd to the Maxon App Tools folder
    cd C:\Program Files\Maxon\Tools
  3. type mx1 then the command, e.g., mx1 license activate  


  1. Open Terminal
  2. cd to the Tools folder
    cd /opt/maxon/maxon_app/bin
  3. type ./mx1 then the command, e.g., ./mx1 user logout


List of the commands:

what it does
user login -u user_email -p user_password Log into an account by entering the email and the account password *
user logout Log out of an account
user info Show the account user info.
service info Show the Maxon service info. 
service stop Stop the service
service start Start the service
service restart Restart the service
license list Show the list of the licenses a user has
license activate license_name Activate a license by using the license name **
license deactivate license_name Deactivate a license
license trial query Show the Maxon One trial status
license trial start Start a Maxon One trial
product list Show the list of the installed products 
product info product_name Show the detailed info on a installed product ***
product activate product_name Activate a product's license
product deactivate product_name Deactivate a product's license
--help How to use the mx1 tool

* 1, to hide the password, press Enter after entering the username. 2, mx1 login does not work for LDAP users

** use mx1 license list to get the license name

*** use mx1 product list to get the product name


Was this article helpful?




Article is closed for comments.