strackt docs
Browse docs

How To

Add a service

Give your application the databases and caches it needs.

Add a service

Most applications need at least one service before they can run — a database to store records, a cache for sessions or queues, or both. This guide covers how to connect an application requirement to a service, whether strackt is setting one up fresh or you already have one running that you want to share.

Before you start: your application needs to be added already, and its requirements confirmed. If you haven't done that yet, start with Add and deploy an application.

Where to find your application's services

Open your application's settings and go to the Services section. This shows every database or cache your application declared as a requirement and whether each one is connected yet.

Requirements that haven't been connected show a Confirm action. Use that to set up the connection.

Connecting a requirement

When you click Confirm on a requirement, strackt checks whether a matching service is already available in your team.

If a matching service exists, the confirm step opens a choice:

  • Connect to an existing service — use a service that's already running. strackt shows you the available services and picks a sensible default. This is the fastest path.
  • Install new on this server — provision a fresh instance of this service directly on the application's server.

Pick the option that fits your setup and confirm. strackt records the connection immediately.

If no matching service exists, strackt proceeds straight to installing a new instance on the server — there's nothing to choose.

What strackt sets up

Once a requirement is confirmed, strackt handles the rest of the provisioning:

  • On the next deploy, strackt creates the database and a dedicated user for your application. Your application only has access to its own database.
  • The connection details — host, port, user, and password — are wired into your application's environment automatically. You don't copy credentials or edit config files by hand.

If you're connecting to a service on a different server, strackt configures the network path between them as well.

Which database you get

When your application needs a SQL database, strackt sets up MariaDB 11.4 LTS — every time. There's no engine to pick and no version to choose: the database picker offers MariaDB and gets you running with a setup that's tested across modern Laravel, WordPress, and Drupal.

If your application was written for MySQL, it runs on MariaDB without changes. The two are drop-in compatible for the things applications actually do, and standing on one well-tested version means fewer surprises when you deploy or upgrade. If strackt detects that your code expected a specific older version, it'll note what it found while still installing the current one.

After connecting

Your application is ready to deploy. Connection details are available as variables in your application's environment configuration if you need to reference them alongside other settings.

A pending change is queued for your application's server. It applies on the next deploy. If you're deploying for the first time, the connection is set up as part of that deploy.

Was this helpful?

Related docs