cells start

./cells start

Start one or more services



Start one or more services on this machine. $ ./cells start [flags] args...

No arguments will start all services available (see 'ps' command).
- Select specific services with regular expressions in the additional arguments. - The -t/--tags flag may limit to only a certain category of services (see usage below) - The -x/--exclude flag may exclude one or more services All these may be used in conjunction (-t, -x, regexp arguments).


Ulimit: set a number of allowed open files greater or equal to 2048. For production use, a minimum of 8192 is recommended (see ulimit -n).

Setcap: if you intend to bind the server to standard http ports (80, 443), you must grant necessary permissions on cells binary with this command: $ sudo setcap 'cap_net_bind_service=+ep'


  1. Start all Cells services $ ./cells start

  2. Start all services whose name starts with pydio.grpc $ ./cells start pydio.grpc

  3. Start only services for scheduler $ ./cells start --tag=scheduler

  4. Start whole plateform except the roles service $ ./cells start --exclude=pydio.grpc.idm.role


  1. Flag mapping

    All the command flags documented below are mapped to their associated ENV var, using upper case and CELLS_ prefix. For example : $ ./cells start --grpc_external 54545 is equivalent to $ export CELLS_GRPC_EXTERNAL=54545; ./cells start

    [Note]: the only exception is the --log flag, that is mapped to CELLS_LOG_LEVEL instead.

  2. Working Directories

  • 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)
  1. Others
  • CELLS_CACHES_HARD_LIMIT: raise memory used by internal caches (in MB, default is 8)
  • CELLS_UPDATE_HTTP_PROXY: if your server uses a client proxy to access outside world, this can be set to query update server.
  • HTTP_PROXY, HTTPS_PROXY, NO_PROXY: Golang-specific environment variables to configure a client proxy for all external http calls.
./cells start [flags]


      --bind string                       Internal IP|DOMAIN:PORT on which the main proxy will bind. Self-signed SSL will be used by default
      --broker_address string             Nats broker port (default ":4222")
      --enable_metrics                    Instrument code to expose internal metrics
      --enable_pprof                      Enable pprof remote debugging
  -x, --exclude stringArray               Select services to start by filtering out some specific ones by name
      --external string                   External full URL (http[s]://IP|DOMAIN[:PORT]) exposed to the outside
      --grpc_cert string                  Certificates used for communication via grpc
      --grpc_external string              External port exposed for gRPC (may be fixed if no SSL is configured or a reverse proxy is used)
      --grpc_key string                   Certificates used for communication via grpc
      --healthcheck int                   Healthcheck port number
  -h, --help                              help for start
      --le_agree                          Accept Let's Encrypt EULA
      --le_email string                   Contact e-mail for Let's Encrypt provided certificate
      --log string                        Sets the log level mode (default "info")
      --nats_monitor_port int             Expose nats monitoring endpoints on a given port
      --no_tls                            Configure the main gateway to rather use plain HTTP
      --registry_address string           Registry connection address (default ":4222")
      --registry_cluster_address string   Registry cluster address
      --registry_cluster_routes string    Registry cluster routes
  -t, --tags stringArray                  Select services to start by tags, possible values are 'broker', 'data', 'datasource', 'discovery', 'frontend', 'gateway', 'idm', 'scheduler'
      --tls_cert_file string              TLS cert file path
      --tls_key_file string               TLS key file path
      --transport string                  Transport protocol for RPC (default "grpc")
      --transport_address string          Transport protocol port (default ":4222")

Options inherited from parent commands


  • ./cells - Secure File Sharing for business
Auto generated by Pydio Cells Home Edition v2.2.4 on 30-Mar-2021
Back to top