| 1-949-236-6510 | |
|
|
|
|
|
|
||||
Atalasoft licensing is file-based (there are certain code based licenses which I will address below - but they're uncommon), and we often get asked where does one find the files.
The username in YOUR_USERNAME is your windows username, not the user name (email address) you use to activate the license. If your name is John Doe, your windows login may be John.Doe or JDoe or John etc... so you'll need to find and use that name.
The X.Y
SDK (development / testing / build) licenses are activated per developer using our activation wizard. For more on activation, please see:
HOWTO: Generate Emergency License Request
Note:: We are currently facing an outage in our system and so you should use the emergency process above and not this one (keeping for reference when we're back up fully): [HOWTO: Activate DotImage SDK or Server (Including Offline Activation)](https://www.atalasoft.com/kb2/KB/50267/HOWTO-Activate-DotImage-SDK-or-Server-Including-Offline-Activation}
That activation process will put the license file(s) in a specific location that is unique to the user who activates and also to the MAJOR.minor version of DotImage
The short answer is the file goes into:
C:\Users\YOUR_USERNAME\AppData\Local\Atalasoft\DotImage X.Y/
the files will have names ending in .lic such as:
The license file is uniquely bound to the machine where it was activated on and can not be copied /moved to another machine. If you're changing machines, you need to activate on the new machine. Please see the above mentioned KB article link for how to activate and feel free to create a support case with Atalasoft support if you have questions/issues activating your license.
So for John Doe who logs into windows as JDoe and activated both 10.7 and 11.4, he will have 2 directories containing his Atalasoft licenses:
For his 10.7 version, they will be in:
C:\users\JDoe\AppData\Local\Atalasoft\DotImage 10.7\
and for his 11.5, they will be in:
C:\users\JDoe\AppData\Local\Atalasoft\DotImage 11.5\
Each developer using DotImage requires their own serials / licenses. An Automated Build process requires licensing as if it were a separate developer.
The license should be activated while logged on to the machine AS the build user. Given the example above where John Doe (logging on to his machine as JDoe) is also managing an automated build machine - on that machine the build logs in as TFS_BuildTFS_Build and activate as normal - so in that case the licenses will be found in:
For the 10.7 version, they will be in:
C:\users\TFS_Build\AppData\Local\Atalasoft\DotImage 10.7\
and for 11.4, they will be in:
C:\users\TFS_Build\AppData\Local\Atalasoft\DotImage 11.4\
Server licenses are distinct from SDK (dev/build) licenses and can be identified by the X in the first group of letters.
EXAMPLE:
DID2 / DIDX2: DotImage Document Imaging - our base SDK and the basis for most all projects using DotImage - serials start with DID2 for developer/SDK licenses but DIDX2 for server versions.
PRP2 / PRPX2 / PRS2 / PRSX2: PdfReader addon serials changed over time - for 10.7 and older they were PRS2 for SDK licenses and PRSX2 for server but for 11.0 and newer, they are PRP2 and PRPX2 respectively.
Over time we've had a LOT of different serials for different products please see INFO: Descriptions of Various Licenses for a complete list.
Unlike SDK licenses, when activated, server licenses are not automatically placed in any specific location. Instead, the activation wizard will ask you where you want to save the license.
As a general rule, for a server deployment, the license file is placed in the application bin directory next to the Atalasoft.*.dll files being referenced/included in the deployment.
So to locate a license for a given application, start by looking in the app's bin directory next to the Atalasoft.dotImage.dll and other Atalasoft.*.dll files being referenced. There may be many different files (Atalasoft.dotImage.lic, Atalasoft.dotImage.Pdfium.lic, Atalasoft.PdfDoc.lic etc...)
Support does not recommend using this location, but at times it's useful - so it's worth checking to even see if it exists:
C:\Program Files (x86)\Atalasoft\DotImage X.Y\bin\
again, the X.Y being 11.4, 11.3, 11.2, etc...
This is a left over relic from over 15 years ago when it used to be the default to install licenses to the SDK install directory. We stopped doing that years ago, switching to the local user AppData\Local directory to avoid needing to be running as Administrator to make changes / activate licenses.
There is a way to specify a custom location for licenses by setting a String key called AssemblyBasePath. The process for doing so is laid out in:
HOWTO: Configure your deployment to use Atalasoft license files in a custom location
If you are unable to find your licenses, they may have been set in that path (it may also be set to the above Program Files location as a default.
Use your Registry editor to find that key (if present)
In rare cases, you may have a CCW, PKL or ATL license which is an XML string that is embedded directly in code with a call to:
Atalasoft.Licensing.SetAssemblyLicense("string of xml here");
If you're unable to find your license files you can search your code for "SetAssemblyLicense" to see if you're using such a license in your app.
You can always search your entire driver for Atalasoft.*.lic files
In conclusion: it is important to be able to find and identify your DotImage license files, and we hope this guide has been useful. As always, if you run into questions, create a support case with Atalasoft support.
FAQ: Where Can I Find My Atalasoft License Files
2025-06-13 - TD