How to reset the controller password

There is no direct way to recover the password. It has to be reset manually.

Below we will assume, that the server is installed as desribed at our Docker and Linux installation instructions.

To begin with, we will have to stop the server.

For Docker:

docker stop agms

For Linux:

sudo systemctl stop agms

Now, we will need to locate the mail server Data directory.

For Docker, get the physical path of the msdata folder.

docker volume inspect msdata

The response will look like this:

"CreatedAt": "2022-04-21T12:00:42-04:00",
"Driver": "local",
"Labels": {},
Mountpoint": "/var/lib/docker/volumes/msdata/_data",
"Name": "msdata",
"Options": {},
"Scope": "local"
] ]

Note the value of Mountpoint. Change to that directory:

cd /var/lib/docker/volumes/msdata/_data

For Linux, the data directory is /srv/agms/Data. Change to that directory:

cd /srv/agms/Data

The server never stores the passwords directly. It uses hashed password values.

Generate the hash for your password:

Password is required.
Confirm password is required.

Now, edit the file ServerOptions.xml using your favorite text editor (we are using nano):

sudo nano ServerOptions.xml

Scroll down, and find RESTUserName and RESTPassword tags. Type the desired User Name, paste the hash of the password we generated above, save the file and restart the container or service:

For Docker:

docker run --name agms -d --rm -v msdata:/app/Data -p 143:143 -p 25:25 -p 110:110 -p 587:587 -p 6060:6060 -p 6061:6061 -p 80:80 -p 443:443 argosoft/agms

For Linux:

sudo systemctl start agms

Now new credentials can be used.