cells start
./cells start
Start one or more services
Synopsis
DESCRIPTION
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).
REQUIREMENTS
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'
EXAMPLES
Start all Cells services $ ./cells start
Start all services whose name starts with pydio.grpc $ ./cells start pydio.grpc
Start only services for scheduler $ ./cells start --tag=scheduler
Start whole plateform except the roles service $ ./cells start --exclude=pydio.grpc.idm.role
ENVIRONMENT
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.
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)
- 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]
Options
--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
SEE ALSO
- ./cells - Secure File Sharing for business