Agency OS

The open source operating system for digital agencies. Built with Directus and Nuxt.

Automatically checked · GitHub checked 2026-11-13

Agency OS

Good fit for

Digital agencies comfortable customizing a Nuxt and Directus application.

Before you switch

This is a customizable application foundation; plan for configuration, development, hosting, and maintenance.

Overview

Agency OS - Complete Nuxt3 + Directus project

AgencyOS

AgencyOS is everything you need to get your agency off the ground, or improve tooling for your existing company. Nuxt 3 Website / Application + Directus Backend.

Brought to you by partnership magic between Directus and NuxtLabs.

Introduction · Features · Installation and Development · Deployment · Tech Stack · Community Help · Contributing



Introduction

One of the easiest parts of running a successful digital agency is doing the actual work. I mean - who doesn't love to put their head down to collaborate, design, and build amazing stuff for clients?

The hard bits are everything else that goes along with that – managing large projects with tons of moving pieces, communicating with clients to properly manage expectations, ensuring you're paid on time, and more.

When every billable hour counts, you don't have the time to build your own tools from scratch. And you shouldn't be forced to settle for off-the-shelf tech that falls short of your preferred workflow.

AgencyOS is the open source operating system to help you run (or start) your digital agency. It's built on open source tools (Nuxt and Directus) and designed to be 100% hackable so you can build YOUR solution, YOUR project management app, YOUR agency's operating system – in record time.

Why?

Quite a few folks on the Directus core team have experience running agencies and we know it's not all rainbows and sunshine. We wanted to build an tool that our agency partners (and any other agency) would get a lot of value from. It was also created as a complete example to showcase the power and flexibility of Directus as a platform to rapidly build your own apps and tools.

Getting Started


Features

Website

When you're hard at work delivering for clients - your own site tends to suffer. AgencyOS includes beautiful website template that's easily customizable and already integrated with an easy-to-use headless CMS.

It's not a starter template. It's a complete website project for you customize or inspire you to build an even better solution.

  • Dynamic page builder with live preview
  • Blog posts and categories
  • Dynamic form generation with validation
  • Dynamic OG image generation
  • Full SEO support out of the box – (meta tags, sitemap, redirects, JSON-LD, and more)
  • Global search functionality
  • Common utilities so you don't need to include yet another package
  • Google Fonts support
  • ESLint and Prettier pre-configured
  • Full dark mode support
  • Themeable with easy config file

CRM / Project Tracker

Maintaining important client relationships doesn't just fall to the sales team. So why maintain separate project management and CRM tools? AgencyOS includes a completely customizable CRM so you can work the way you want.

  • Organizations and contacts
  • Sales pipeline and activities
  • Dynamic project proposal builder
  • Project and task management
  • Customizable project templates
  • Invoicing and expense tracking
  • Customize and build your own dashboards without writing code
  • Automate processes using Directus Flows

Client Portal

Communication is probably the biggest driver of project success. With AgencyOS's private client portal - you can insure your clients stay up to date and even hold them accountable for delivering the files and information you need to complete their project

  • Private authenticated portal for clients to self-serve
  • Clients can view their projects, tasks, and files
  • Clients can pay invoices through Stripe
  • Assign tasks to clients as part of project templates



Installation and Development

AgencyOS is structured as a monorepo with two main parts:

  • directus/ – Directus backend (Docker Compose + template data)
  • nuxt/ – Nuxt 3 frontend (website + client portal)

Project Structure

agency-os/
├── directus/              # Directus backend
│   ├── docker-compose.yaml
│   ├── .env.example
│   ├── run-scripts/       # Flow operation scripts
│   └── template/          # Directus schema and sample content
├── nuxt/                  # Nuxt 3 frontend
│   ├── package.json
│   ├── nuxt.config.ts
│   └── ...
├── package.json           # Root config (directus:template metadata)
└── README.md

Quick Start (Recommended)

The fastest way to get started is with the Directus Template CLI:

npx directus-template-cli@latest init --template=https://github.com/directus-labs/agency-os

This sets up both the Directus backend (Directus 11) and the Nuxt frontend for you. Before starting the frontend, create a static token for the admin user (see step 2) and set it as DIRECTUS_SERVER_TOKEN in nuxt/.env.

Manual Setup

1 - Set Up Directus Backend

There are two ways to get a Directus instance running:

Option A - Directus Cloud

The easiest option. Register at directus.cloud and create a new project. Directus offers a 14 day free trial which is plenty of time to try AgencyOS. See pricing for details.

Option B - Self-Host with Docker

PostgreSQL is the tested and preferred database for this project.

cd directus
cp .env.example .env
docker compose up -d
# Directus will be available at http://localhost:8055/

You'll need Docker installed. See the Directus Docker Guide for more details.

Important Note: Community self-hosted instances are not covered by Directus support. For enterprise support, contact the Directus team.

2 - Generate a Static Token for the Admin User

You need a static token to seed the project with the template data.

  1. Go to the User Directory in your Directus instance
  2. Choose the Administrative User
  3. Scroll down to the Token field
  4. Generate token and copy it
  5. Save the user (don't forget to save!)

3 - Apply the AgencyOS Template

The Directus template lives in this repo at directus/template. Open your terminal, run the following command, and follow the prompts.

npx directus-template-cli@latest apply
  1. Choose From a public GitHub repository.
  2. Paste https://github.com/directus-labs/agency-os/tree/main/directus/template
  3. Paste the URL to your Directus instance
  4. Paste your Admin user static token
  5. Wait for the script to finish

Or apply it in one command:

npx directus-template-cli@latest apply -p \
  --directusUrl="http://localhost:8055" \
  --directusToken="your-static-token" \
  --templateType="github" \
  --templateLocation="https://github.com/directus-labs/agency-os/tree/main/directus/template"

Learn more about the Directus Template CLI.




4 - Set Up the Nuxt Frontend

cd nuxt
cp .env.example .env

Update the .env with your Directus URL and token.

pnpm install
pnpm dev

Visit http://localhost:3000

To build for production:

pnpm build

Deployment

Deploying the Nuxt Frontend

Please check the official Nuxt Deployment Documentation for supported providers. Here are a few popular options:

One Click Options

Note: When deploying, set the Root Directory to nuxt/ in your hosting provider's settings.

Vercel

Deploy with Vercel

Netlify

Deploy to Netlify

Note: For Netlify, set the Base directory to nuxt/ in your site settings.

Deploying the Directus Backend

If you don't want to mess with DevOps, spin up a project on Directus Cloud in about 90 seconds.

For self-hosting, Docker is the recommended approach. See the Directus Docker Guide.

Resources for Self Hosting Directus




Tech Stack

Nuxt

Build your next Vue.js application with confidence using Nuxt. An open source framework under MIT license that makes web development simple and powerful.

Learn more about Nuxt


Directus

Directus is a headless CMS that instantly turns your SQL database into REST and GraphQL APIs and gives you a beautiful, intuitive no-code app to manage all your content and data.

Learn more about Directus


UI

Utilities

  • VueUse – Collection of Vue Composition Utilities.
  • VueUse Motion – Composables for component animations.

Community Help


Contributing

AgencyOS is a community driven project so we'd love to have your contributions.

Thanks To

AgencyOS was created by Bryant Gillespie (@bryantgillespie). But big thank yous are owed to...