How to Resolve the Issue of Installation Stuck at 0% in BotCity Studio ?
Overview
If you're trying to install BotCity Studio or start the BotCity Runner and the installation gets stuck at 0%, or you experience authentication or login errors, it is very likely that your corporate environment is blocking the required network access.
This issue is common in corporate networks that enforce strict security and internet access policies.
Common Symptoms
The following behaviors are frequently observed in restricted environments:
Installer (Wizard) stuck at 0%.
Login failure in BotCity Studio.
Authentication error when launching the BotCity Runner.
Likely Cause
BotCity tools require internet access to communicate with cloud services, authenticate users, and install packages. When this communication is blocked by firewalls, corporate proxies, or network restrictions, these errors can occur.
Recommended Solution
Contact your company’s IT team and request that the following network access rules be whitelisted to ensure proper functioning of BotCity tools.
Network Requirements for Corporate Environments
The Maestro orchestrator runs in the cloud, and the Runner needs to communicate with it via HTTPS (port 443). This port must be open for outbound traffic, but it is not actively occupied by the Runner.
| Service Type | URL |
|---|---|
| Communication with Maestro | https://*.botcity.dev/ |
| BotCity SDK access | https://sdk.botcity.dev/ |
| Authentication service | https://auth.botcity.dev/ |
Using Python for Development
If you're using Python for automation development, ensure that the required tools and external package repositories are accessible.
- Python version 3.8 or higher
Required tools:
pip,virtualenv, andsetuptools
| Service | URL |
|---|---|
| Official Python Package Index (PyPI) | https://pypi.org/* |
| Package hosting domain | https://files.pythonhosted.org/ |
files.pythonhosted.org is used by PyPI to host package versions. If this URL is blocked, package installation with pip may fail.Conclusion
Installation and authentication issues in BotCity tools are often caused by restricted corporate networks. Once the necessary URLs and ports are whitelisted, the tools should function as expected.
For more technical information, visit the official BotCity documentation.
Related Articles
How to Diagnose and Fix Installation, Authentication, or Execution Issues with BotCity Tools
Diagnosis To assist in identifying these issues, starting from version 1.2.5, the Wizard now includes the Diagnostic tool, which aims to check: Connectivity with BotCity services Possible network blocks Installed versions of Python and Java in the ...Troubleshooting when using ‘Print Screen’ in BotCity Studio
In some sporadic cases, when using the 'Print Screen' key to take a screenshot, the captured image is not displayed in Studio. This behavior may be related to several factors, such as other applications intercepting the 'Print Screen' action, ...Why is the Runner stuck on "Executing task..." and how to fix it?
Overview Occasionally, the BotCity Runner may appear stuck after retrieving a new task from the queue. In these cases, the status remains as: Executing task... and the automation does not actually start until the Runner is manually restarted. Likely ...How to Resolve the “ModuleNotFoundError” When Running Your Automation?
Overview If you encounter the following error when running your automation: ModuleNotFoundError: No module named 'botcity' this means the Python environment being used to run the automation cannot find the required package. This issue is typically ...What Features Are Available on a Free BotCity Maestro Account ?
Description A common question from new users of BotCity Maestro is what features are included in a free (community) account. These questions often come through the support chat on the sign-up screen, and usually include: How many bots can I create? ...