Configuration

Most global configuration for Manyfold is via environment variables. These could be set in your docker configuration as shown in Get Started, in a .env file for local development, or in some other way that makes sense for your deployment setup.

This page lists the available environment variables, and describes the effect of each one.

Required

The variables in this section must be set, or the application will not start.

PUID and PGID

Version 0.69.0+

Set the user and group IDs that the Manyfold application should run as. Works the same as it does in Linuxserver containers.

For example: PUID=1000 and PGID=1000

To get your user and group IDs, run id and look at the uid and gid values. Read our security guide for more details.

SECRET_KEY_BASE

A secret key used to sign browser cookies; normally a 128-digit hexadecimal number, but any long random string will do. If you have the code checked out, you can generate one with bundle exec rails secret. Changing this will invalidate all user cookies and sessions.

REDIS_URL

manyfold image only, not required for manyfold-solo

A string that includes all the information necessary to connect to a Redis server, in the form redis://{redis_server}:{port}/{dbnumber}; for instance redis://redis:6379/1.

Database

If you’re using the manyfold image, you need to provide either a DATABASE_URL or a set of separate DATABASE_* parameters. If you’re using manyfold-solo, as long as you have mounted persistent storage at /config, you do not need any more database configuration.

DATABASE_ADAPTER

Version 0.72.0+

Specifies the type of database being connected to. Supported values are:

DATABASE_ADAPTER Server Default?
postgresql PostgreSQL yes
mysql2 MySQL or MariaDB  
sqlite3 SQLite  

DATABASE_HOST

Version 0.60.0+

The hostname of your database server. Not required for sqlite3.

DATABASE_USER

Version 0.60.0+

The username used to authenticate to your database server. Not required for sqlite3.

DATABASE_PASSWORD

Version 0.60.0+

The password used to authenticate to your database server. Not required for sqlite3.

DATABASE_NAME

Version 0.60.0+

For postgresql and mysql2, this should be the name of the database you want to use. For sqlite3, this should specify the absolute path of the database file, e.g. /config/manyfold.sqlite3

DATABASE_CONNECTION_POOL

Version 0.70.0+

Specifies the number of database connections to share across the application. Defaults to RAILS_MAX_THREADS or 16, which should be fine in most cases.

DATABASE_URL

A single string that combines all the information necessary to connect to your database. This will override any other information specified in the other DATABASE_* variables. The exact format varies slightly depending on the database adapter you want to use:

  • PostgreSQL: postgresql://{username}:{password}@{database_server}/{database_name}?pool={pool_size}
  • MySQL/MariaDB: mysql2://{username}:{password}@{database_server}/{database_name}?pool={pool_size}
  • SQLite: sqlite3:{absolute_path_of_database_file}?pool={pool_size}

Features

DEMO_MODE

Version 0.55.0+

Set to enabled to put the entire site into the demo mode used on try.manyfold.app. In this mode, all deletion, upload, and advanced admin features are disabled, even in single-user mode and for administrator users. You’re pretty unlikely to need it, though perhaps you could use it as a sort of “emergency lockdown” mode.

REGISTRATION

Version 0.59.0+

If MULTIUSER is enabled, set to enabled to allow new users to sign up for account. If disabled, users will need to be invited by an admin. Off by default.

Users can be invited by navigating to Settings -> Advanced Administration > Users > New User

MULTIUSER

Version 0.59.0+

Set to enabled to turn on multiuser features such as account login, signup (with REGISTRATION option), permissions, roles, and so on. By default this is off, and Manyfold operates in single-user mode without any login necessary; however, if you’re exposing your Manyfold instance on the public Internet, even if you intend to only use it yourself, it’s probably a good idea to enable multiuser for security.

You should set a secure administrator password before turning on multiuser mode. Manyfold should prompt you to do so when you first access version 0.59.0 or above.

FEDERATION

Version 0.75.0+

Set to enabled to turn on cross-server ActivityPub federation features such as remote following, webfinger discovery, etc. If you want your Manyfold instance to be part of the Fediverse, this is the setting for you. Make sure that PUBLIC_HOSTNAME and PUBLIC_PORT are set, and HTTPS_ONLY is highly recommended. Note that at present, only public content will be federated.

Authentication

Manyfold supports single sign-on using OpenID Connect (OIDC), using the following environment variables. As well as these, make sure to set PUBLIC_HOSTNAME and PUBLIC_PORT. If you need to set an allowed redirect URL in your OIDC provider configuration, use http{s}://{PUBLIC_HOSTNAME}/users/auth/openid_connect/callback

OIDC_CLIENT_ID

Version 0.83.0+

A valid client ID from your OIDC provider.

OIDC_CLIENT_SECRET

Version 0.83.0+

The corresponding client secret from your OIDC provider.

OIDC_ISSUER

Version 0.83.0+

The full “issuer” string of your OIDC prover, including scheme and any trailing slashes. This should be exactly as shown in your OIDC provider’s documentation or dashboard.

OIDC_NAME

Version 0.83.0+

Shown in the OIDC login button; set to the name of your provider (e.g. “Authentik”) to customise the button text. Shows “OpenID Connect” by default.

FORCE_OIDC

Version 0.83.0+

Set to enabled to disable logging in with local accounts, and force all login to use your OIDC provider.

Network

HTTPS_ONLY

Version 0.69.0+

Put the application into HTTPS-only mode, including automatic HTTPS redirection, Strict-Transport-Security, and secure cookies. Read the security page for important details.

The HSTS header has a long expiry time, so this is effectively a one-way switch! By turning it on you will lose unencrypted access to your instance for a long time, so make sure HTTPS is working first!

RAILS_RELATIVE_URL_ROOT

If you are mapping Manyfold to a non-root path via a reverse proxy like nginx, use this option to tell Manyfold what the root path is; for instance /manyfold.

Email

Some multiuser features are only enabled if an email server is configured, such as password recovery, email verification, and so on.

In order to send mail, you need an SMTP server to send through; this could be your own local mail server, your own email host like gmail, or a hosted SMTP service like Mandrill.

SMTP_SERVER

Version 0.61.0+

The hostname of your SMTP server, e.g. smtp.example.com. The default port 25 will be used.

If the server supports TLS, it will be used automatically with STARTTLS, but otherwise an unencrypted connection will be used. See ActionMailer’s SMTP documentation for details. Defaults to localhost.

SMTP_USERNAME

Version 0.61.0+

The username for your mail server, if authentication is required.

SMTP_PASSWORD

Version 0.61.0+

The password for your mail server, if authentication is required.

SMTP_FROM_ADDRESS

Version 0.61.0+

The email address that mails should appear to be sent from. If not set, mail is sent from notifications@{PUBLIC_HOSTNAME}.

PUBLIC_HOSTNAME

Version 0.61.0+

The hostname of your publicly-accessible service, e.g. try.manyfold.app. This variable is used to create links in emails, and must be set for email delivery to work.

PUBLIC_PORT

Version 0.61.0+

If your public service is on a non-standard port, set it here (e.g. 3214).

Performance

WEB_CONCURRENCY

Sets the number of web workers run by the application. Recommended to be the same or slightly less than the number of available CPU cores for best performance. Defaults to 4. The number of concurrent requests that can be served is WEB_CONCURRENCY * RAILS_MAX_THREADS.

RAILS_MAX_THREADS

The maximum number of threads that each worker should run. Each thread can serve one request at a time, so the number of concurrent requests that can be served is WEB_CONCURRENCY * RAILS_MAX_THREADS. Defaults to 16.

DEFAULT_WORKER_CONCURRENCY

Version 0.70.0+

The number of standard worker threads to run. If you have more CPU power and memory, you may want to increase this to get faster job processing. 4 by default.

PERFORMANCE_WORKER_CONCURRENCY

Version 0.70.0+

The number of high-performance worker threads to run. High-performance workers run intensive jobs like geometric analysis and file conversion, and use a lot of memory and CPU power. Set to 1 by default, so that demanding jobs don’t saturate the Manyfold server, but if you have lots of CPU and memory available, you can increase this to process more jobs in parallel.

Customisation

SITE_NAME

Version 0.83.0+

Set the name of your site to whatever you want, e.g. “Bob’s 3D Stash”; it’s “Manyfold” by default.

SITE_TAGLINE

Version 0.83.0+

Customise the tagline shown on the homepage; shown below the site name, above the search box.

SITE_ICON

Version 0.83.0+

Customise the site icon shown in the navigation bar. Set it to a URL to your logo, which will be displayed 40 pixels high.

Miscellaneous

MAX_FILE_EXTRACT_SIZE

Version 0.69.0+

The maximum individual file size (written as an integer number of bytes) that will be extracted from uploaded archives. 1073741824 (1GiB) by default.

MAX_FILE_UPLOAD_SIZE

Version 0.69.0+

The maximum individual file size (written as an integer number of bytes) that can be uploaded. 1073741824 (1GiB) by default.

USAGE_REPORTING_URL

Version 0.67.0+

Set this URL in order to redirect anonymous usage tracking to your own endpoint; mainly if you want to verify what we’re sending. See the tracking page for more details.