Skip to main content


This section is designed to help you quickly find answers to common questions and provide you with a better understanding of Appcircle server and runner.

Appcircle Server FAQ

Can I change the password of the initial user?

For now, you shouldn't change the initial user password you defined in the global.yaml.

Does Appcircle support LDAP login?

Appcircle supports LDAP login on the Testing Distribution and Enterprise App Store modules.

Appcircle doesn't support LDAP login on the Appcircle dashboard, where you login to create build profiles and other developer-related jobs.

We can't send mail to outside domains.

Let's say your company's domain is And you can send mail from Appcircle to, but you can't send mail to

You should check the SMTP configuration and allow SMTP server to send mail to outside domains.

While installing the Appcircle server with Podman, minio containers can't get healthy status.

The podman network backend should be netavark. You can check the current settings with the command below:

podman info | grep -i networkBackend

If you need to use a proxy on the Appcircle server, you should configure proxy settings according to the Proxy Configuration document.

We are facing "manifest not found" error when we run the up command.

If you are using the Nexus registry and are facing a "manifest not found" error, this is an expected case to occur. Nexus proxy has a known bug while pulling multiple container images. You should pull images one by one as a workaround.

To pull images one by one, you can edit the script here and create a new shell script. Then you can pull images one by one with this script. So you won't face "manifest not found" error any more.

Where should we download the zip package while we are updating?

Download the zip package of the appcircle server and extract it to the same folder as the already existing Appcircle server folder. Your data and configuration will be saved while updating.

How do I change Docker or Podman's data location?

For more details on changing the location of Docker data, refer to the Change the Docker Data Location page.

For more details on changing the location of Podman data, refer to the Change the Podman Data Location page.

I'm offline on the Appcircle dashboard on my browser.

You should trust the Appcircle's or your organization's root CA certificate on your computer.

Appcircle Runner FAQ

We are facing a self-signed certificate error on builds.

The certificate of your organization should be trusted on the Appcircle runner virtual machines.

You should refer to the Custom Certificates page for more details.

We are facing an "SSL certificate is not valid yet" error on builds.

The runner VMs cannot connect to the servers to update their date and time due to network restrictions.

You should configure NTP server settings in the runner VMs. For updating base runners, please refer to the Update Base Images section.

For details on configuring NTP settings, you can refer to the NTP Configuration section and follow the steps.

We can't register Appcircle runner to the server.

First, you should check if your Appcircle runner can access the Appcircle server. You can run the command below to test this. You should change the example Appcircle URL for yourself.

curl -v

You should check if there is a self-signed certificate problem. You can refer to the Custom Certificates page to trust the root CA certificate of your organization.

If you already trusted the root CA cert, you should check the Appcircle server's certificate. If it is too long, like 5 years, it should be trusted using the graphical user interface. You should open the Keychain Access application from the GUI and add the Appcircle server's certificate. After that, you should click on the certificate and select "Always trust".