# SimStudio Migrations

SimStudio Migrations is a one-time container that runs database migrations to initialize and update the PostgreSQL schema for SimStudio's self-hosted AI agent and workflow platform. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3314/simstudio-migrations

## Description

SimStudio Migrations is a one-time container that runs database migrations to initialize and update the PostgreSQL schema for SimStudio's self-hosted AI agent and workflow platform. It must complete successfully before starting the simstudio-app and simstudio-realtime containers.

## Platform availability

Available on 2 of 10 platforms: Unraid, Mac.

## Desktop and other devices

Mac.

## Health score

84/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 90 (29,979 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Official website: https://simstudio.ai
- Unraid: https://ca.unraid.net/apps/simstudio-migrations-0bcbukm0ya4tpm?q=simstudio-migrations
- GitHub: https://github.com/simstudioai/sim
- Documentation: https://simstudio.ai/knowledge
- desktop: https://github.com/simstudioai/sim/releases/latest

## Common questions

### Does the migrations container need to keep running after it has run the schema migrations?

No. It runs the migrations and exits, while the app and realtime services wait until the database is healthy and migrations are complete.

### Which image tag should I use for the migrations container during an upgrade?

Use the same tag for the app, realtime, and migrations images because they share the database schema. Mismatched tags can make the app run against an incompatible schema.

### Does npx sim-setup clone the Sim repository during self-hosted setup?

No. It creates a sim deployment directory, provisions the database, generates secrets, writes the env file, and starts the published images with Docker Compose.

### Will sim-setup down delete my database or other managed data?

No. sim-setup down removes containers but keeps data. sim-setup reset archives the env file and wipes managed data.

### Which local port is the self-hosted Sim app exposed on after setup?

After the setup wizard finishes, open the app on port 3000.

## Alternatives

- Zapier: Automate workflows effortlessly, connecting over 7,000 apps without coding.
- langflow: Langflow is an open-source platform for building and deploying AI-powered agents and workflows.
- n8n: n8n is a self-hosted, fair-code workflow automation platform that connects 1,500+ apps and application programming interfaces (APIs) on a v…

---
Source: Our Local Host (https://ourlocalhost.com/app/3314/simstudio-migrations), the self-hosted and open-source app directory.
