- Getting started with the Maxon app on Linux
- a) Downloading the Maxon app
- b) Installing the Maxon app
- c) Uninstalling the Maxon app
- d) Loggin in and out of your account
- e) Listing your licenses
- f) Trial licenses
- Technical support
- a) Submitting a support ticket
- b) Redshift-related license errors
- Advanced use cases (aimed at technical directors or system administrators)
- a) Verifying that the service is available
- b) Verifying that the service is running
- c) Licensing Workflows
- d) Listing your products
- e) An overview of all available commands:
1) Getting started with the Maxon App on Linux
a) Downloading the Maxon App
Go to https://www.maxon.net/try and download the Linux version of the Maxon App. That will download a file called Maxon_App_2023.1.1_Linux.sh.
b) Installing the Maxon App
Open a terminal window, and
cd to the directory where you downloaded the Maxon app Maxon_App_2023.1.1_Linux.sh.
Alternatively, you can go to that location, right-click, and select 'Open in Terminal'.
Then in the terminal run
sudo sh Maxon_App_2023.1.1_linux.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 uninstall_maxon_app.sh file.
sudo sh uninstall_maxon_app.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 myemail.com 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>
./mx1 license assign net.maxon.license.app.bundle_maxonone~trial
This will result in: Successfully assigned a license for whatever identifier you selected.
Similarly to deactivate a license use the
release command. For example:
./mx1 license release net.maxon.license.app.bundle_maxonone~trial Successfully release 'net.maxon.license.app.bundle_maxonone~trial'.
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.
- from my.maxon.net, release the license
- uninstall Maxon App (by the method shown above)
- install the latest Maxon App version
- log into your account using ./mx1
- 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 (start_srv.sh) Tasks: 16 (limit: 48088) Memory: 15.9M CGroup: /system.slice/maxon_app.service ├─992 /bin/bash /opt/maxon/maxon_app/bin/start_srv.sh └─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
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
How to use it:
- Launch Terminal
- cd to the Maxon App Tools folder
cd /Library/Application\ Support/Maxon/Tools
- Type ./mx1 then the command, e.g., ./mx1 user login -u -p 12345
- Open Command Prompt
- cd to the Maxon App Tools folder
cd C:\Program Files\Maxon\Tools
- type mx1 then the command, e.g., mx1 license activate net.maxon.license.app.bundle_maxonone-release~commercial
- Open Terminal
- cd to the Tools folder
- 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