You can find below a list of problems commonly encountered when installing and configuring Pydio Cells and Pydio Cells Mobile Application, together with strategies to diagnose and fix them.

You can find more use cases and solution in our FAQ, our Knowledge Base and our forum.

Cells Server

Cells working directories

By default, application data is stored under the standard OS application dir:

  • Linux: ${USER_HOME}/.config/pydio/cells
  • Darwin: ${USER_HOME}/Library/Application Support/Pydio/cells
  • Windows: ${USER_HOME}/ApplicationData/Roaming/Pydio/cells

You can customize the various storage locations with the following ENV variables:

  • CELLS_WORKING_DIR: replace the whole standard application dir
  • CELLS_DATA_DIR: replace the location for storing default datasources (default CELLS_WORKING_DIR/data)
  • CELLS_LOG_DIR: replace the location for storing logs (default CELLS_WORKING_DIR/logs)
  • CELLS_SERVICES_DIR: replace location for services-specific data (default CELLS_WORKING_DIR/services)

Progress freezes during browser install

  • No progress appears during install

During the installation process, if there is no progress bar but the console is still showing some activities; it is OK. A manual refresh at the end of the install will load the login page.

  • The wizard is stuck at the end of the install

After the install, if the page does not refresh automatically in tls self-signed mode it is OK.
A manual refresh will load the login page.

Unable to bind port 443

You have configured the bind URL with port 443 and enable redirection of port 80. You get an error page "Unable to connect" when you try to connect.

Check the error log, if you sse such an error:

2018-05-21T10:55:57.532+0200   ERROR   pydio.grpc.gateway.proxy   Could not run   {"error": "listen tcp :443: bind: permission denied"}

You probably did not give permission to the cells binary file to use reserved ports. To fix this:

sudo setcap 'cap_net_bind_service=+ep' cells address

If you are behind a reverse proxy and get 404: this page is not served on this interface when trying to access the web UI, you can try to use the generic IP address in your bind URL.

This basically tells to the embedded web server that acts as the main internal gateway of the application to accept all requests on this port.

In contrary, if you give a specific valid IP or a domain name in the bind URL, the embedded web server checks the "HOST" header of the incoming requests. If the header does not exactly matches with the DN or IP of the bind URL, the server throw a 404 file not found error.

Remember, when the bind URL is<port> (the port is compulsory), and if you are not using a well-known port 80 or 443, you must also include the port in the external URL that must look like: <scheme>://<IP or DN>:<port>, for instance http://localhost:8080, otherwise, you might stay stuck on a grey loading page.

Hydra Error after install

On first start or just after the installation terminated, you get such an error:

 [0002] Could not ensure that signing keys for "" exists. This can happen if you forget to run "hydra migrate sql", set the wrong "secrets.system" or forget to set "secrets.system" entirely.  error="cipher: message authentication failed"

It usually means you have performed a new install on top of a former install without correctly cleaning (a.k.a dropping) the DB.

Unable to log in

After a re-install, when trying to login, you get a could not load session store: securecookie: the value is not valid error.

This is bound to the part of the session mechanism that resides in the browser, on client side. To solve the issue, get rid of all cookie for this site and refresh the page.

I locked my user

You can unlock the admin or any user with the CLI (assuming that you have access on the server), run the following command ./cells user unlock -u <username>.

I forgot the password of a user

Once again with the CLI (assuming that you have access on the server), you can run ./cells user set-pwd -u <username> -p <new password>

Cells Sync

Cannot list workspaces

If you are getting an error when you attempt to list the workspaces then your server might be running behind a reverse proxy, in this case you must use TLS on Cells and on the reverse proxy, please refer to our dedicated documentation Running Cells Behind a reverse Proxy.

I do see not my workspaces

Make sure that your workspaces can be synchronized (enable settings in workspace menu)

Unable to create or list folder on local system

  • macOS users might require permissions, System Preferences > Security & Privacy > Files and Folders and allow access.

Missing package (LINUX)

  • If you are getting this error (on Gnome):
./cells-sync: error while loading shared libraries: cannot open shared object file: No such file or directory
  • Then install sudo apt install libappindicator3-1

Still stuck?

In case you do not find the answer you are looking for here, please do not ask question in github issues, nor in Twitter or other social feed: our preferred communication channel is our Forum.

So, what should I do in case of:

And only if you're invited to:

  • Post a github issue: make sure to put as much detail as possible.
  • or submit a pull request.
Back to top