Diaspora

Learn about configurations >

• admin_account | string

  Once created, set admin account username here.

• admin_email | string

  Set pod administrator email here. This will also be visible in the terms and privacy policy pages, if enabled.

• backup_aws_access_key_id | string

  AWS Username

• backup_aws_secret_access_key | string

  AWS Password

• backup_backend | string

  Default: swift

  At the moment "swift", "u1" and "s3" backends are supported.

• backup_destination | string

  Default: backup

  Remote folder where to store the backups.

• backup_ftp_password | string

  OAuth token in the FTP_PASSWORD form used by duplicity.

• backup_passphrase | string

  Default: passphrase

  PGP passphrase duplicity will use to encrypt the backup.

• backup_schedule | string

  Default: daily

  Frequency of backup.

• backup_sources | string

  Default: ["/tmp/files"]

  List of folder to backup, in json format.

• backup_strategy | string

  Default: full

  Duplicity supports either "full" or "incremental" backup strategy.

• backup_swift_password | string

  Swift Password

• backup_swift_url | string

  Swift URL

• backup_swift_username | string

  Swift Username

• bitcoin_address | string

  Bitcoin address for donations.

• branch | string

  Default: master

  Branch to use. Does not normally need to be changed.

• enable_registrations | boolean

  Default: True

  Enable new users to create accounts.

• facebook_app_id | string

  Facebook app id for services integration.

• facebook_app_secret | string

  Facebook app secret if ID given.

• facebook_authorized | string

  Default: false

  Facebook authorized users scope (0.5.1.x ->)

• hostname | string

  Pod hostname in the format `domain.tld`. Subdomains are allowed. Subfolders are not supported by diaspora* at this moment. NOTE! This is *required* and *cannot* be changed after installation. Changing will not take any effect on the diaspora* installation.

• logging_debug | boolean

  Enable or disable certain error and debug logging. Keep this disabled if you don't need this information or want to run the pod with as little memory as possible.

• mail_smtp_authentication | string

  Default: plain

  Authentication type for SMTP, if used. Either 'plain', 'login', 'cram_md5' or 'none'.

• mail_smtp_domain | string

  Sending 'HELO' command domain for SMTP server, if used. By default pod domain will be used - otherwise set it here.

• mail_smtp_host | string

  Host for SMTP mail server, if used

• mail_smtp_password | string

  Password for SMTP mail server, if used

• mail_smtp_port | int

  Default: 587

  Port for SMTP mail server, if used

• mail_smtp_username | string

  Username for SMTP mail server, if used

• mail_type | string

  Default: sendmail

  How emails are sent, options: sendmail or smtp. If smtp, don't forget to set mail_smtp_host.

• maintenance_remove_old_users | boolean

  Default: True

  Remove old inactive users automatically in the background. This happens after 2 years of inactivity. A warning will be sent to the account and if the user doesn't log in within 30 days, the account will automatically be deleted.

• podname | string

  Default: diaspora*

  A name for the pod.

• post_backup_script_path | string

  Default: /usr/local/sbin/post_backup.sh

  Path to the script to run after starting the backup.

• post_restore_script_path | string

  Default: /usr/local/sbin/post_restore.sh

  Path to the script to run after starting the backup.

• pre_backup_script_path | string

  Default: /usr/local/sbin/pre_backup.sh

  Path to the script to run before starting the backup.

• pre_restore_script_path | string

  Default: /usr/local/sbin/pre_restore.sh

  Path to the script to run before starting the backup.

• relay_inbound | boolean

  Default: True

  Subscribe to relay posts.

• relay_outbound | boolean

  Default: True

  Push out public posts to a relay.

• repository | string

  Default: diaspora/diaspora

  Repository to use. Does not normally need to be changed.

• sidekiq_concurrency | int

  Default: 2

  Number of parallel threads Sidekiq uses. Increase this gradually if Sidekiq cannot process jobs fast enough. 2 is good for a minimal pod. The higher this setting, the more memory Sidekiq will need. Warning, do not increase this over 25 without increasing 'pool' in config/database.yml!

• ssl_cert | string

  SSL cert for pod domain. See readme how to best use this configuration value.

• ssl_chain | string

  SSL chain for cert. See readme how to best use this configuration value.

• ssl_key | string

  SSL private key for pod domain. See readme how to best use this configuration value. Must be unencrypted.

• ssl_snakebite | boolean

  Default: True

  If you don't set 'ssl_key' and 'ssl_cert', by default the default snakebite self-signed certifications will be used until a proper cert is set. Set this to false once you transfer the cert manually to the server. Note! diaspora* requires a valid SSL certificate for federation. Running a production real diaspora* pod using snakebite certs is **not** possible.

• ssl_startssl | boolean

  If you are using Start SSL for your certficates, then set to 'True'. diaspora* requires a valid SSL certificate for federation.

• statistics | boolean

  Enable statistics from the pod? This includes user and post counts. Statistics will be exposed at /statistics.json

• terms | boolean

  Enable Terms of Service? A default ToS document will be shown to users wanting to create accounts.

• terms_agelimit | int

  Set a positive number to activate this setting. This age limit is shown in the default ToS document.

• terms_jurisdiction | string

  If you enable a ToS, you should define what jurisdiction is used to handle legal disputes. For example, state/country or country, depending on your location.

• tumblr_key | string

  Tumblr key for services integration.

• tumblr_secret | string

  Tumblr secret if ID given.

• twitter_key | string

  Twitter key for services integration.

• twitter_secret | string

  Twitter secret if key given.

• verbose_curl_debug | boolean

  Enable verbose curl debug logging.