Quick Start

This guide walks you through deploying your SmartCAD instance. Plan on about 30 minutes for the whole flow.

Don't have SmartCAD yet? Purchase through our Discord. You'll receive a bundle with your license key, docker-compose, and this guide.

Step 1 — Prepare your files

Place the docker-compose.yml and .env I sent you in a fresh directory on your server (e.g. ~/smartcad/).

Step 2 — Point your domain

In your DNS provider, create an A record pointing your domain to your server's IP address.

cad.yourcommunity.com  →  A  →  your.server.ip

Note: Caddy (bundled with the app) automatically obtains and renews a TLS certificate via Let's Encrypt. Ports 80 and 443 must be open on your server's firewall.

Step 3 — Set up a Discord application

You'll need a Discord application for OAuth login. See Discord OAuth for the full walkthrough — it takes about 5 minutes.

Step 4 — Fill in your .env

Open the .env from your install bundle and replace every __FILL_IN__ placeholder. The most important:

• BASE_URL — your public HTTPS URL (e.g. https://cad.yourcommunity.com)
• BETTER_AUTH_SECRET — generate with openssl rand -base64 32
• DISCORD_CLIENT_ID + DISCORD_CLIENT_SECRET — from your Discord application
• DISCORD_REQUIRED_ROLE_IDS — at least one role ID required for CAD access

Your LICENSE_KEY and DISCORD_GUILD_ID are already filled in.

See Environment Variables for the full reference.

Step 5 — Start your SmartCAD instance

docker compose up -d

This pulls the images and starts the backend, web server, and Watchtower. First startup may take 30–60 seconds while Caddy obtains your TLS certificate.

Visit https://cad.yourcommunity.com — you should see the login page.

Step 6 — First login

1. Log in with Discord using an account that has one of your configured roles
2. You will be prompted to set a password — this is used for in-game FiveM login where Discord OAuth is unavailable

Step 7 — FiveM server configuration

See FiveM Integration for installation and convar setup.

What's next

• Configure roles — map Discord roles to officer / supervisor / command access
• Update SmartCAD — Watchtower handles this automatically