Skip to main content

​
Get started in three steps

This guide will get you from zero to editing your first video in OpenCut as quickly as possible.
1

Install prerequisites

Install Bun, the JavaScript runtime and package manager used by OpenCut:
Bun is like npm or yarn but faster. If you already have Node.js installed, you can also use npm, but Bun is recommended for the best experience.
Docker is optional but recommended if you want authentication and project saving features. For frontend-only editing features, you can skip Docker.
  • Docker Desktop: Download here
  • Docker Compose: Included with Docker Desktop
If you skip Docker, you can still use OpenCut for editing, but user accounts and cloud sync won’t work.
2

Clone and setup

Clone the repository and install dependencies:
If you installed Docker, start the database and Redis:
This starts:
  • PostgreSQL database on port 5432
  • Redis cache on port 6379
  • Serverless Redis HTTP adapter on port 8079
The .env.example file has sensible defaults that match the Docker Compose config. It should work out of the box.
3

Start editing

Start the development server:
Open http://localhost:3000 in your browser and start editing!
You’re all set! OpenCut is now running locally. Try importing a video and exploring the timeline editor.

​
Verify installation

Once OpenCut is running, you should see:
  • The OpenCut homepage at http://localhost:3000
  • An empty project timeline ready for editing
  • The ability to import media files
If you encounter issues:
If port 3000 is already in use, you can change it:
Or kill the process using port 3000:
Make sure Bun is in your PATH. After installation, restart your terminal or run:
If you’re seeing database errors:
  1. Make sure Docker is running: docker ps
  2. Check if the database container is healthy: docker compose ps
  3. Verify the DATABASE_URL in apps/web/.env.local matches the Docker config
Default value:

​
Next steps

Now that OpenCut is running:

Explore features

Learn about timeline editing, multi-track support, and more

Keyboard shortcuts

Speed up your workflow with keyboard shortcuts

Full installation

See detailed installation options including self-hosting

Contributing

Help improve OpenCut by contributing code or reporting bugs

​
Available scripts

Here are the most useful commands for development:
The development server supports hot module replacement (HMR), so your changes will appear instantly without refreshing the page.