Related versions: v19 and newer
Possible reasons based on the frequency of occurrence
Archicad or BIMcloud / BIMcloud Basic is not up-to-date
Make sure that all Archicad clients and BIMcloud / BIMcloud Basic components are updated to the latest build.
Archicad must be able to communicate with BIMcloud / BIMcloud Basic to provide Teamwork. To verify this, run the Network Diagnostic Tool from the Open / Join dialog or the Teamwork Palette. Verify whether all necessary ports are open and the server machine is available from the client machine.
Whenever possible, use wired connection to the network. Try turning off the wireless connection to make sure you can access the BIMcloud / BIMcloud Basic's computer over the network.
BIMcloud Manager not available - not even from the browser
Try to open the Manager web user interface on the computer where BIMcloud Manager is installed. If it cannot be opened or if it seems the Server cannot be started properly, then check the Operating BIMcloud page for further help.
BIMcloud / BIMcloud Basic does not have a fixed IP address / hostname
Make sure to use either a fixed IP address, a hostname or a Fully Qualified Domain Name (FQDN) for BIMcloud / BIMcloud Basic. For further information and recommendations, see the Network Requirements article.
Domain Name Server (DNS) is not set properly
On a client computer, verify whether the IP address is correct: in the Command Prompt (Windows) / Terminal (macOS), use the
nslookup host command (where the host is the address of BIMcloud / BIMcloud Basic Server computer, without the port number).
Domain Name Server (DNS) cache needs to be flushed
Flush the DNS on a client computer by using the following command at the Command Prompt (Windows) / Terminal (macOS)
sudo dscacheutil -flushcache
Server's / client's computer name does not match
Double check that the names of the computers match their hostnames. Use Command Prompt (Windows) / Terminal (macOS) and run the
hostname command. Compare the result with the name of the computer - the two names must be the same.
- Open the System panel from the Control Panel on Windows to verify the computer name.
- Open the System Preferences > Sharing on macOS to verify the computer name.
Do not use special characters in the server computer's name. A valid hostname can include letters (a-z, A-Z), numbers (0-9) and the hyphen (-) characters.
Teamwork is used in a mixed environment
Avoid using space characters in file servers' name, and avoid some special characters in file names, libraries or library parts. For example:
'', '/', ':', '*', '?', '"', '<', '>', '|'
3rd party applications are blocking the communication on the server side
Antiviruses, firewalls, backup or any other monitoring applications (e.g. Windows Search, macOS Spotlight) tend to scan all files in real time, which can cause huge performance issues on the server side. Turn off file indexing and add the Projects and Attachments folders to the exception list in your antivirus / firewall settings.
3rd party applications are blocking the communication on the client side
Similar to the server side, monitoring apps can interrupt the communication between Archicad and BIMcloud / BIMcloud Basic. In the settings of the above-listed applications, add Archicad and its folders to the exception list. Make sure to schedule 3rd party backups to run outside of working hours.
Forward proxy is installed
Make sure to add the BIMcloud / BIMcloud Basic address(es) to the bypass list.
Reverse proxy is installed
Make sure that the reverse proxy is HTTP 1.1 compatible, at least. Configure the reverse proxy's TCP connection timeout setting to allow long-time TCP connections.
Port of the BIMcloud Manager is used by another process (new installation)
If the BIMcloud Manager cannot be opened in a browser, try to reconfigure the Manager to use another port.
Connection storing file is corrupted
Delete the TeamworkLoginDataStore2.json file (version 19 and above). Locations:
Deleting the .json
files will cause that the previously added server will be removed from the server list in the Open / Join / Share dialogs.
Network infrastructure issue
Software and hardware issues in the network infrastructure can cause trouble as well. Make sure the driver of the Network Interface Card is up-to-date. Verify the hardware side: check network cabling and test the performance of the Network Interface Card by copying a large file to the server computer through the network.
If you still experience the above issue, please contact your GRAPHISOFT support representative. For the investigation Archicad FastLogger files and BIMcloud log files might be necessary.