Skip to content

FAQ / Troubleshooting

Troubleshooting SeaTable Server

SeaTable doesn't start / Webinterface is not reachable

First let's try to find out, where the problem is. If you try to access your SeaTable Server goes like this:

Browser -> Domain/DNS -> Caddy -> Nginx -> SeaTable Container -> SeaTable Server

Check the following solutions to determine what is not running.

Verify that SeaTabler Server is running

Execute docker logs seatable-server. This should result in:

2024-02-04 12:59:17 Start server
SeaTable started
2024-02-04 12:59:21 For more startup information, please check the /opt/seatable/logs/init.log
2024-02-04 12:59:21 This is an idle script (infinite loop) to keep container running.

Another check might be:

docker exec -it seatable-server curl http://127.0.0.1:8000/server-info/

This should return:

{"version":"4.3.8","edition":"enterprise edition"}

If you don't see this, SeaTable Service is definately not running. Try to start the service from the docker container and check the logs for more details. Here are the two commands...

  • docker exec -it seatable-server seatable.sh
  • tail -f /opt/seatable-server/seatable/logs/*.log

Probably you have a wrong configuration value in dtable_web_settings.py.

Verify that SeaTable Container is healthy

Execute docker ps. This should be the result:

CONTAINER ID   IMAGE                               STATUS                NAMES
0411d977eb25   seatable/seatable-enterprise:4.3.8  Up 3 days (healthy)   seatable-server

If the container is not (healthy), you can be sure, that something is wrong with the container.

Check nginx

There might be a misconfiguration of nginx.conf. nginx provides a configuration checker.

docker exec -it seatable-server nginx -t

It should look like:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

If not, check the nginx configuration file at /opt/seatable-server/seatable/conf/nginx.conf.

Check Caddy
docker logs caddy

more info will follow.

Domain/DNS

execute curl https://<your-seatable-server-domain> or ping <your-seatable-server-domain> to get more details.

Other typical problems
  • License expired or not provided
  • PLUGIN_REPO_ID wrong in dtable_web_settings.py
  • spaces in COMPOSE_FILE variable in .env file.

FAQ's

If, for whatever reason, the installation fails, how do I to start from a clean slate again?

Stop all containers, remove the directories caddy, mariadb, seatable-compose, and seatable-server in /opt and start again.

To stop all containers, change to /opt/seatable-compose and run docker compose down.

I want to run my SeaTable Server instance on my local machine? Can I do that?

You can, but it is only recommended for testing purposes. Follow the instructions for the single-node deployment and simply set SEATABLE_SERVER_HOSTNAME and SEATABLE_SERVER_PROTOCOL to 127.0.0.1 and 'http', respectively, in the .env file. To access your local SeaTable Server instance, enter http:\127.0.0.1 in your browser.

If you want to enable https, consult section Custom Certificates for details.

I want to use my own reverse proxy / my custom certificate, how do I do that?

You can opt out of using Caddy and use another webserver of your choice. In this case, remove caddy.yml from the COMPOSE_FILE variable in the .env file and follow the instructions in section Custom Revers Proxy.