You can install Swift in your own environment when being in complete control of your data is important.

If you have purchased a swift self-hosting license you will either:

• Have received details with in install script and license key
• Can log into https://app.swiftcentre.org/ and see you License details by navigating to Admin → Workspace → Self-host License

Server Requirements

• Docker must be be installed and the user running the swift install must have privileges to it
• Linux (windows coming soon)

Beta Release

Because this is a beta feature expect some minor issues and need for support.

Limitations:

• backup: There is not automated backup of data yet. You should backup the docker volumes by your own means until this has been added.
• upgrades: You can install new version on top of old ones. But a smooth way to quickly upgrade you instance in planned.
• Linux only: If you have windows servers let your swift contact know and we will add support. If you have a distro other than Debian or Ubuntu, contact your swift contact and we will ensure this works beforehand.

Common Issues/FAQ:

• If you don’t have docker and choose to let us install it. It might not detect that the installation worked until you restart. If this happens ctrl+c to exit, then open a new shell and run swift again.

Swift Installer

The script installs a CLI tool to manage the swift install.

Note: To review the script details open the URL in the script, i.e. https://app.swiftcentre.org/install-sh

It will install to ~/.swift/ and you can run it ~/.swift/swift to list and select commands:

start

Starts the swift services.

On a fresh server, it will:

• ask for a swift license
• ensure docker is installed
• generate configuration ~/.swift/cfg/app.env secrets ~/.swift/cfg/secrets.env as needed for the swift services to run
  • You may want to manage your own secrets. You can copy them into a secrets manager, and ensure that the swift tool has all of them when running commands.
• use docker compose to download the required images
• user docker compose to start the services
• configure the database to have a default workspace with you as an admin

On an existing server it will

• ensure the services are started
• upgrade the database if needed

stop

Stops the swift services.

• By default the data stored in docker columns will be left as is.
• When you next start it will still have the data. Because some data is encrypted you must be careful not to lose secrets.

To factory reset run stop --delete-data --delete-cfg

config

Select one of the following to configure

Email server: enter the details to an SMTP server. If you don’t have one already, we recommend postmark

Public URL: If you specify an address with https e.g. https://swift.mydomain.com we will configure certificates for you automatically. Before you do so, make sure that domain points to this server so we can respond to challenges to verify that you own the domain. It usually takes up to a minute for this to take effect.

License: Input a license key, or sign into to swift (needs a browser running on the same server)

Gemini: Lets you specify a Google Gemini API KEY, which will allow for AI functionality in the app. For example, question suggestions and comparison searches. Follow these instructions from Google to get one.