Running in Production

Advices to read before deploying an application using Spinach to production.


Since Spinach relies heavily on threads the user’s code MUST be thread-safe. This is usually quite easy to achieve on a traditional web application because frameworks like Flask or Django make that obvious.

Tasks should not store state in the process between invocations. Instead all state must be stored in an external system, like a database or a cache. This advice also applies to views in a web application.


Most Spinach features are implemented as Lua scripts running inside Redis. Having a solid installation of Redis is the key to Spinach reliability.

To ensure that no tasks are lost or duplicated, Redis must be configured with persistence enabled. It is recommended to use AOF persistence (appendonly yes) instead of periodic RDB dumps. The default of fsync every second (appendfsync everysec) is a good trade-off between performance and security against sudden power failures.

Using Redis as a task queue is very different from using it as a cache. If an application uses Redis for both task queue and cache, it is recommended to have two separated Redis servers. One would be configured with persistence and without eviction while the other would have no persistence but would evict keys when running low on memory.

Finally standard security practices apply: Redis should not accept connections from the Internet and it should require a password even when connecting locally.


If the application is deployed on multiple servers it is important that their clocks be approximately synchronized. This is because Spinach uses the system time to know when a job should start. Running an ntp daemon is highly recommended.

Workers should be started by an init system that will restart them if they get killed or if the host reboots.

Production Checklist


  • Tasks that are NOT safe to be retried have their max_retries set to 0
  • Tasks that are safe to be retried have their max_retries set to a positive number
  • Retries happen after an exponential delay with randomized jitter (the default)
  • Task args and kwargs are JSON serializable and small in size
  • Jobs are sent in Batch to the broker when multiple jobs are to be scheduled at once
  • The user’s code is thread-safe
  • Tasks do not store state in the process between invocations
  • Logging is configured and exceptions are sent to Sentry, see Integrations
  • Different queues are used if tasks have different usage pattens, see Queues
  • Different namespaces are used if multiple Spinach applications share the same Redis server, see Engine


  • Redis uses AOF persistence
  • Redis does not evict keys when running low on memory
  • The Redis server used by Spinach is not also used as a cache
  • Connections are secured by a long password
  • Connections are encrypted if they go through the public Internet


  • Servers have their clock synchronized by ntp
  • Workers get restarted by an init system if they get killed