Skip to main content
Version: Next

FAQs

Please refer to the FAQ below to resolve your issue, if you cannot find the solution, please contact Websoft9 support.

Websoft9 Console

500 Internal Server Error?

Description: When checking the logs of websoft9-apphub container, 500 Internal Server Error appears.

Reason: The websoft9-apphub container is working abnormally or it can not connect other websoft9 containers

Solution: Run the following commands to check the cause of the error

docker exec -it websoft9-apphub cat /websoft9/apphub/logs/apphub_error.log

Can not open App Store or My Apps?

Description: I can login Websoft9 Console, but can not open "App Store" or "My Apps" interface

Reason: websoft9 containers working abnormally or 80 port not enabled

Solution: Run the following commands to check the cause of the error

docker logs websoft9-proxy
docker exec -it websoft9-apphub cat /websoft9/apphub/logs/apphub_error.log

Login Websoft9 failed

Using multiple reasons can cause login failure:

  • Security Group port 9000 not enabled
  • Websoft9 installation failed
  • Network access failed for your instance
  • Local browser's cookie or session
  • Your Linux not allowed password login

websoft9.service starting failed?

  1. Troubleshooting compute resource limit

    # View processes
    ps aux

    # Check disk space
    df -lh

    # View memory usage
    free -lh
  2. Check the error logs

    # View the Websoft9 service container logs
    docker logs websoft9-apphub
    docker logs websoft9-git
    docker logs websoft9-proxy
    docker logs websoft9-deployment

    # View Websoft9 service status and logs
    systemctl status websoft9
    journalctl -u websoft9
    ``

Websoft9 can not running at 9000 port?

Running netstat -tunlp to check which process is using port 9000, then free the port with kill -9 PID.

Docker starting failed?

Running systemctl status docker and journalctl -xe to check error logs

Applications

Access application 502 error

Description: Nginx 502 Bad Gateway

Reason: Application container failure proxy by Nginx

Solution: Troubleshoot the application container from

  • Insufficient computing resources of server
  • Application containers stopped running
  • Application containers port error

Application error when DB changed?

Description: Application error when modify database password from DB commands or DB tools

Reason: Application can not connect when modify database password because DB connection string changed

Solution: Modify database connection string at Compose of My Apps

Can't access application from Internet?

Description: I can't access application from Internet, but I can access it from Intranet.

Reason: Internet is not available or access from the Internet is denied

Solution: Here are some of the common causes

  • Container port is not exposed to the host machine or does not have a proxy to the host machine.
  • The container denies access from the Internet
  • The port corresponding to the server's security group is not open.